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Abstract (Basic) : EP 984396 A2 

NOVELTY - Each of the regions (1-10) is defined by a region outline 
following at least one of the set outlines or their parts. Each region 
is examined to determine those the objects which contribute to the 
region. The compositing expression is modified on the basis of the 
contribution of each of the objects within the region to form an 
optimized compositing expression for each the region. The image is 
composited using each of the optimized compositing expressions. 

USE - For creation of computer-generated images both in the form of 
still pictures and video imagery made up by compositing multiple 
components . 

ADVANTAGE - Improved efficiency, reduced cost while excluding 
problems related to overlapping transparent and semi-transparent areas 
by handling a full range of compositing operations. 

DESCRIPTION OF DRAWING (S) - The drawing illustrates the compositing 
operations after being optimized according to one example of the 
preferred embodiment. 
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Optimising Image Compositing 

ABSTRACT 



A method and apparatus for creating an image is disclosed. The image is formed 
by rendering at least a plurality of graphical objects to be composited according to a 
compositing expression. Each object has a predetermined outline. The method 
comprises the following steps. Firstly, dividing a space in which the outlines are defined 
into a plurality of mutually exclusive regions wherein each of the regions is defined by a 
region outline substantially following at least one of the predetermined outlines or parts 
thereof. Secondly, examining each of the regions to determine those objects which 
contribute to the regions. Thirdly, modifying the compositing expression on the basis of 
the contribution of each of the objects within the region to form an optimised compositing 
expression for each region. Fourthly, compositing the image using each of the optimised 
compositing expressions. 



15/16 



_T_ 

Subdivide image space 
into mutually exclusive 
regions. 



2301 




2311 



Combine region image 
data to form one image 



I 



End 



Determine which 
objects contribute to 
the region. 



^_2303 



I 



Optimise compositing 
expression. 



2305 



Render image data for 
region. 



2307 



Fig. 23 



S & F Ref: 471466 



AUSTRALIA 
PATENTS ACT 1990 

COMPLETE SPECIFICATION 

FOR A STANDARD PATENT 



ORIGINAL 



Name and Address 
of Applicant: 



Canon KabushlM Kalsha 

30-2, Shlmomaruko 3-chome 

Ohta-ku 

Tokyo 1 46 

OAPAN 



Actual Inventor(s): Martin Paul Tlaskal, Timothy Merrick Long 



Address for Service: 



Invention Title: 



Spruson & Ferguson, Patent Attorneys 

Level 33 St Martins Tower, 31 Market Street 

Sydney, New South Wales, 2000, Australia 

Optimizing Image Compositing 



ASSOCIATED PROVISIONAL APPLICATION DETAILS 

[31] Application No(s) [33] Country 

PP5688 AU 
PP5687 AU 



[32] Application Date 
3 September 1998 
3 September 1998 



The following statement Is a full description of this invention, 
Including the best method of performing 1t known to me/us:- 



• • • 

> • « 

• • • 



• • • • • 



• • • • 

• m • 



• • • • 

• • • 

• • • • 

• • 



- 1 - 

OPTIMISING IMAGE COMPOSITING 

Field of the Invention 

The present invention relates to the creation of computer-generated images both in 
the form of still pictures and video imagery, and, in particular, relates to efficient process, 
5 apparatus, and system for creating an image made up by compositing multiple compo- 
nents. 

Background 

Computer generated images are typically made up of many differing components or 
graphical elements which are rendered and composited together to create a final image. 

10 In recent times, an "opacity channel" (also known as a "matte", an "alpha channel", or 
simply "opacity") has been commonly used. The opacity channel contains information 
regarding the transparent nature of each element. The opacity channel is stored alongside 
each instance of a colour, so that, for example, a pixel-based image with opacity stores an 
opacity value as part of the representation of each pixel. An element without explicit 

15 opacity channel information is typically understood to be fully opaque within some 
defined bounds of the element, and assumed to be completely transparent outside those 
bounds. 

An expression tree offers a systematic means for representating an image in terms 
of its constituent elements and which facilitates later rendering. Expression trees 

20 typically comprise a plurality of nodes including leaf nodes, unary nodes and binary 
nodes. Nodes of higher degree, or of alternative definition may also be used. A leaf 
node, being the outer most node of an expression tree, has no descendent nodes and 
represents a primitive constituent of an image. Unary nodes represent an operation which 
modifies the pixel data coming out of the part of the tree below the unary operator. 

25 Unary nodes include such operations as colour conversions, convolutions (blurring etc) 
and operations such as red-eye removal. A binary node typically branches to left and 
right subtrees, wherein each subtree is itself an expression tree comprising at least one 
leaf node. Binary nodes represent an operation which combines the pixel data of its two 
children to form a single result. For example, a binary node may be one of the standard 

30 "compositing operators" such as OVER, IN, OUT, ATOP and alpha-XOR, examples of 
which and other are seen in Fig. 20. 

Several of the above types of nodes may be combined to form a compositing tree. 
An example of this is shown in Fig. 1. The result of the left-hand side of the compositing 
tree may be interpreted as a colour converted image being clipped to spline boundaries. 
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This construct is composited with a second image. 

Although the non-transparent area of a graphical element may of itself be of a 
certain size, it need not be entirely visible in a final image, or only a portion of the 
element may have an effect on the final image. For example, assume an image of a 

5 certain size is to be displayed on a display. If the image is positioned so that only the top 
left comer of the image is displayed by the display device, the remainder of the image is 
not displayed. The final image as displayed on the display device thus comprises the 
visible portion of the image, and the invisible portion in such a case need not be rendered. 
Another way in which only a portion of an element may have an effect is when the 

10 portion is obscured by another element. For example, a final image to be displayed (or 
rendered) may comprise one or more opaque graphical elements, some of which obscure 
other graphical elements. Hence, the obscured elements have no effect on the final 
image. 

A conventional compositing model considers each node to be conceptually infinite 
15 in extent. Therefore, to construct the final image, a conventional system would apply a 
compositing equation at every pixel of the output image. Interactive frame rates of the 
order greater than 15 frames per second can be achieved by relatively brute-force 
approaches in most current systems, because the actual pixel operations are quite simple 
and can be highly optimised. This highly optimised code is fast enough to produce 
20 acceptable frame rates without requiring complex code. However, this is certainly not 
true in a compositing environment. 

The per-pixel cost of compositing is quite high. This is because typically an image 
is rendered in 24-bit colour in addition to an 8-bit alpha channel, thus giving 32 bits per 
pixel. Each compositing operator has to deal with each of the four channels. Therefore, 
25 the approach of completely generating every pixel of every required frame when needed 
is inefficient, because the per-pixel cost is too high. 

Problems arise with prior art methods when rendering graphical objects which 
include transparent and partially-transparent areas. Further, such methods typically do 
not handle the full range of compositing operators. 
30 Summary of the Invention 

It is an object of the present invention to substantially overcome, or ameliorate, one 
or more of the deficiencies of the above mentioned methods by the provision of a method 
for creating an image made up by compositing multiple components. 

According to one aspect of the present invention there is provided a method of 
35 creating an image, said image being formed by rendering at least a plurality of graphical 
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objects to be composited according to a compositing expression, each said object having 
a predetermined outline, said method comprising the steps of: 

dividing a space in which said outlines are defined into a plurality of mutually 
exclusive regions wherein each of said regions is defined by a region outline substantially 
5 following at least one of said predetermined outlines or parts thereof; 

examining each said region to determine those said objects which contribute to said 
region; 

modifying said compositing expression on the basis of the contribution of each of 
said objects within said region to form an optimized compositing expression for each said 
10 region; and 

compositing said image using each of said optimized compositing expressions. 

According to another aspect of the present invention there is provided a method of 
creating an image, said image being formed by rendering at least a plurality of graphical 
objects to be composited according to a compositing expression, each said object having 
15 a predetermined outline, said method comprising the steps of: 

dividing a space in which said outlines are defined into a plurality of mutually 
exclusive regions; 

examining each said region to determine those said objects which contribute to said 
region; 

20 modifying said compositing expression on the basis of the contribution of each of 

said objects within said region; and 

compositing said image using said modified compositing expression. 
According to still another aspect of the present invention there is provided a method 
of creating an image, said image comprising a plurality of graphical objects to be 
25 composited according to a compositing expression, said method comprising the steps of: 
dividing a space in which said graphical objects are defined into a plurality of 
regions; 

examining each said region to determine those said objects which contribute to said 
region; 

30 modifying said compositing expression on the basis of said examination; and 

compositing said image using said modified compositing expression. 
According to still another aspect of the present invention there is provided an 
apparatus for creating an image, said image being formed by rendering at least a plurality 
of graphical objects to be composited according to a compositing expression, each said 
35 object having a predetermined outline, said apparatus comprising: 
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dividing means for dividing a space in which said outlines are defined into a 
plurality of mutually exclusive regions wherein each of said regions is defined by a 
region outline substantially following at least one of said predetermined outlines or parts 
thereof; 

5 examining means for examining each said region to determine those said objects 

which contribute to said region; 

modifying means for modifying said compositing expression on the basis of the 
contribution of each of said objects within said region to form an optimized compositing 
expression for each said region; and 
10 compositing means for compositing said image using each of said optimized 

compositing expressions. 

According to still another aspect of the present invention there is provided an 
apparatus for creating an image, said image being formed by rendering at least a plurality 
of graphical objects to be composited according to a compositing expression, each said 
15 object having a predetermined outline, said apparatus comprising: 

dividing means for dividing a space in which said outlines are defined into a 
plurality of mutually exclusive regions; 

examining means for examining each said region to determine those said objects 
which contribute to said region; 
20 modifying means for modifying said compositing expression on the basis of the 

contribution of each of said objects within said region; and 

compositing means for compositing said image using said modified compositing 
expression. 

According to still another aspect of the present invention there is provided an 
25 apparatus for creating an image, said image comprising a plurality of graphical objects to 
be composited according to a compositing expression, said apparatus comprising: 

dividing means for dividing a space in which said graphical objects are defined into 
a plurality of regions; 

examining means for examining each said region to determine those said objects 
30 which contribute to said region; 

modifying means for modifying said compositing expression on the basis of said 
examination; and 

compositing means for compositing said image using said modified compositing 
expression. 

35 According to still another aspect of the present invention there is provided a method 



of creating a series of images, each member of said series being related to a preceding 
member, said images being formed by rendering a plurality of graphical objects to be 
composited according to a hierarchical structure representing a compositing expression, 
said hierarchical structure including a plurality of nodes each representing a component 
of at least one of said images, each of said objects having a predetermined outline, said 
method comprising the steps of: 

(a) for each said node: 

(i) dividing a component image space in which said outlines are defined 
into at least one mutually exclusive region, each said region being related to at least one 
graphical object; 

(ii) examining each said region to determine those objects that contribute to 

the region; 

(b) creating internodal dependency information identifying those said regions that 
will be affected by a change in any one of said regions; 

(c) rendering a first image of said series by compositing all regions substantially 
according to said hierarchical structure; 

(d) in response to at least one change to at least one of said nodes; 

(i) examining said internodal dependency information to identify those of 
said regions affected by said at least one change; 

(ii) for each node with affected regions, updating the corresponding 
identified regions and incorporating into said node those (any) new regions arising from 
the change and/or removing any of said regions that are no longer relevant; 

(iii) updating said internodal dependency information to reflect changes to 
said hierarchical structure; 

(iv) rendering a further image of said series by compositing (only) those 
regions affected by said at least one change; and 

(e) repeating step (d) for further changes to at least one of said nodes. 
According to still another aspect of the present invention there is provided a method 

of creating a series of images, said images being formed by rendering a plurality of 
graphical objects to be composited according to a hierarchical structure, said hierarchical 
structure including a plurality of nodes each representing a component of at least one of 
said images, each of said objects having a predetermined outline, said method comprising 
the steps of: 

(a) for each said node: 

(iii) dividing a space in which said outlines are defined into at least one 
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mutually exclusive region; 

(iv) examining each said region to determine those objects that contribute to 

the region; 

(b) creating intemodal dependency information based on said examination; 
5 (c) rendering a first image of said series utilising said hierarchical structure; 

and then, in response to at least one change to at least one of said nodes; 

(d) examining said internodal dependency information; 

(i) for a node with affected regions, updating the corresponding regions; 

(ii) updating said internodal dependency information; 

10 ("0 rendering a further image of said series by compositing those regipns 

affected by said at least one change; and 

(e) repeating step (d) for further changes to at least one of said nodes. 
According to still another aspect of the present invention there is provided a method 

of creating a series of images, said images being formed by rendering at least a plurality 
15 of graphical objects to be composited according to a hierarchical structure, said 
hierarchical structure including a plurality of nodes each representing a component of at 
least one of said images, said method comprising the steps of: 

(a) for each said node: 

(i) dividing a component image space in which said graphical objects are 
20 defined into at least one region; 

(ii) examining each said region; 

(b) creating intemodal dependency infoimation for each of said regions; 

(c) rendering a first image of said series utilising said hierarchical structure; 
and then, in response to at least one change to at least one of said nodes; 

25 (d) examining said internodal dependency information; 

(i) for a node with affected regions, updating the corresponding 
information; 

(ii) updating said internodal dependency record; 

(iii) rendering a further image of said series; and 

30 (e) repeating step (d) for further changes to at least one of said nodes. 

According to still another aspect of the present invention there is provided an 
apparatus for creating a series of images, each member of said series being related to a 
preceding member, said images being formed by rendering a plurality of graphical objects 
to be composited according to a hierarchical structure representing a compositing 

35 expression, said hierarchical structure including a plurality of nodes each representing a 
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component of at least of one of said images, each of said objects having a predetermined 
outline, said apparatus comprising: 

dividing means for dividing a component image space in which said outlines are 
defined , for each said node, into at least one mutually exclusive region, each said region 
5 being related to at least one graphical object ; 

first examining means for examining each said region, for each said node, to 
determine those objects that contribute to the region; 

creating means for creating an internodal dependency information identifying those 
said regions that will be affected by a change in any one of said regions; 
10 rendering means for rendering a first image of said series by compositing all regions 

substantially according to said hierarchical structure; 

second' examining means for examining said internodal dependency information to 
identify those of said regions affected by at least one change to at least one of said nodes; 

first updating means for updating the corresponding identified regions for each node 
15 with affected regions and incorporating into said node those (any) new regions arising 
from the change; 

second updating means for updating said internodal dependency information, to 
reflect changes to said hierarchical structure; and 

rendering means for rendering a further image of said series by compositing (only) 
20 those regions affected by said at least one change. 

According to still another aspect of the present invention there is provided an 
apparatus for creating a series of images, said images being formed by 'rendering at least a 
plurality of graphical objects to be composited according to a hierarchical structure, said 
hierarchical structure including a plurality of nodes each representing a component of at 
25 least one of said images, each of said objects having a predetermined outline, said 
apparatus comprising: 

dividing means for dividing a space in which said outlines are defined, for each said 
node, into at least one mutually exclusive region; 

first examining means for examining each said region, for each said node, to 
30 determine those objects that contribute to the region; 

creating means for creating internodal dependency information based on said 
examination; 

rendering means for rendering a first image of said series utilising said hierarchical 
structure; and 

35 second examining means for examining said internodal dependency information in 



response to at least one change to at least one of said nodes and, for a node with affected 
regions, updating the corresponding regions, updating said intemodal dependency 
information and, rendering a further image of said series by compositing those regions 
affected by said at least one change. 

According to still another aspect of the present invention there is provided an 
apparatus for creating a series of images, said images being formed by rendering at least a 
plurality of graphical objects to be composited according to a hierarchical structure, said 
hierarchical structure including a plurality of nodes each representing a component of at 
least one of said images, said apparatus comprising: 

dividing means for dividing a component image space, for each said node, in which 
said graphical objects are defined into at least one region; 

first examining means for examining each said region; 

creating means for creating intemodal dependency information for each of said 
regions; 

rendering means for rendering a first image of said series utilising said hierarchical 
structure; 

second examining means for examining said intemodal dependency information, in 
response to at least one change to at least one of said nodes; and 

first updating means for updating the corresponding regions for an affected node; 

second updating means for updating said intemodal dependency information; and 

rendering means for rendering a further image of said series. 

According to still another aspect of the present invention there is provided a 
computer program product including a computer readable medium hiving a plurality of 
software modules for creating an image, said image being formed by rendering at least a 
plurality of graphical objects to be composited according to a compositing expression, 
each said object having a predetermined outline, said computer program product 
comprising: 

dividing module for dividing a space in which said outlines are defined into a 
plurality of mutually exclusive regions wherein each of said regions is defined by a 
region outline substantially following at least one of said predetermined outlines or parts 
thereof; 

examining module for examining each said region to determine those said objects 
which contribute to said region; 

modifying module for modifying said compositing expression on the basis of the 
contribution of each of said objects within said region to form an optimized compositing 
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expression for each said region; and 

compositing module for compositing said image using each of said optimized 
compositing expressions. 

According to still another aspect of the present invention there is provided a 
5 computer program product including a computer readable medium having a plurality of 
software modules for creating an image, said image being formed by rendering at least a 
plurality of graphical objects to be composited according to a compositing expression, 
each said object having a predetermined outline, said computer program product 
comprising: 

10 dividing module for dividing a space in which said outlines are defined into a 

plurality of mutually exclusive regions; 

examining module for examining each said region to determine those said objects 
which contribute to said region; 

modifying module for modifying said compositing expression on the basis of the 
15 contribution of each of said objects within said region; and 

compositing module for compositing said image using said modified compositing 
expression. 

According to still another aspect of the present invention there is provided a 
computer program product including a computer readable medium having a plurality of 
20 software modules for creating an image, said image comprising a plurality of graphical 
objects to be composited according to a compositing expression, said computer program 
product comprising: 

dividing module for dividing a space in which said graphical objects are defined 
into a plurality of regions; 
25 examining module for examining each said region to determine those said objects 

which contribute to said region; 

modifying module for modifying said compositing expression on the basis of said 
examination; and 

compositing module for compositing said image using said modified compositing 
30 expression. 

According to still another aspect of the present invention there is provided a 
computer program product including a computer readable medium having a plurality of 
software modules for creating a series of images, each member of said series being 
related to a preceding member, said images being formed by rendering a plurality of 
35 graphical objects to be composited according to a hierarchical structure representing a 
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compositing expression, said hierarchical structure including a plurality of nodes each 
representing a component of at least one of said images, each of said objects having a 
predetermined outline, said computer program product comprising: 

dividing module for dividing a component image space in which said outlines are 
5 defined, for each said node, into at least one mutually exclusive region, each said region 
being related to at least one graphical object ; 

first examining module for examining each said region, for each said node, to 
determine those objects that contribute to the region; 

creating module for creating an internodal dependency information identifying 
10 those said regions that will be affected by a change in any one of said regions; 

rendering module for rendering a first image of said series by compositing all 
regions of said hierarchical structure; 

second examining module for examining said internodal dependency information to 
identify those of said regions affected by at least one change to at least one of said nodes; 
15 first updating module for updating the corresponding identified regions for each 

node with affected regions and incorporating into said node those (any) new regions 
arising from the change; 

second updating module for updating said internodal dependency information to 
reflect changes to said hierarchical structure; and 
20 rendering module for rendering a further image of said series by compositing (only) 

those regions affected by said at least one change. 

According to still another aspect of the present invention there is provided a 
computer program product including a computer readable medium having a plurality of 
software modules for creating a series of images, said images being formed by rendering 
25 a plurality of graphical objects to be composited according to a hierarchical structure, said 
hierarchical structure including a plurality of nodes each representing a component of at 
least one of said images, each of said objects having a predetermined outline, said 
computer program product comprising: 

dividing module for dividing a space in which said outlines are defined, for each 
30 said node, into at least one mutually exclusive region; 

first examining module for examining each said region, for each said node, to 
determine those objects that contribute to the region; 

creating module for creating an internodal dependency information based on said 
examination; 

35 rendering module for rendering a first image of said series utilising said hierarchical 
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structure; and 

second examining module for examining said internodal dependency information in 
response to at least one change to at least one of said nodes and, for a node with affected 
regions, updating the corresponding regions, updating said -internodal dependency 
5 information and, rendering a further image of said series by compositing those regions 
affected by said at least one change. 

According to still another aspect of the present invention there is provided a 
computer program product including a computer readable medium having a plurality of 
software modules for creating a series of images, said images being formed by rendering 
10 a plurality of graphical objects to be composited according to a hierarchical structure, said 
hierarchical structure including a plurality of nodes each representing a component of 
said image, said computer program product comprising: 

dividing module for dividing a component image space, for each said node, in 
which said graphical objects are defined into at least one region; 
15 first examining module for examining each said region; 

creating module for creating internodal dependency information for each of said 
regions; 

rendering module for rendering a first image of said series utilising said hierarchical 
structure; 

20 second examining module for examining said internodal dependency information, 

in response to at least one change to at least one of said nodes; and 

first updating module for updating the corresponding regions for a node with 
affected regions; 

second updating module for updating said internodal dependency information; and 

25 rendering module for rendering a further image of said series. 

According to still another aspect of the present invention there is provided a method 

of processing image data for creating an image by rendering graphical objects to be 
composited according to a compositing expression, comprising the steps of: 

dividing a space in which said objects are defined into a plurality of regions in 
30 accordance with outlines of the objects; 

examining a part of the space by utilizing each said region; and 

modifying the compositing expression based on a result of said examining step. 
Brief Description of the Drawings 

Embodiments of the present invention will now be described with reference to the 
35 following drawings: 
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Fig. 1 is an example of a compositing tree; 

Fig. 2 illustrates an image containing a number of overlapping objects and the 
corresponding compositing tree; 

Fig. 3 shows the image of Fig. 2 illustrating the different regions which exist in the 
image and listing the compositing expression which would be used to generate the pixel 
data for each region; 

Fig. 4 is the image of Fig. 3, illustrating the compositing operations after being 
optimised according to one example of the preferred embodiments; 

Fig. 5 illustrates the result of combining two region descriptions using the Union 
operation according to the preferred embodiments; 

Fig. 6 illustrates the result of combining two region descriptions using the 
Intersection operation according to the preferred embodiments; 

Fig. 7 illustrates the result of combining two region descriptions using the 
Difference operation according to the preferred embodiments; 

Figs. 8A to 8D illustrate the steps involved in combining two region groups using 
the Over operation according to the present invention; 

Fig. 9 illustrates an image and compositing tree according to an example of a 
further embodiment of the present invention; 

Fig. 10 illustrates an image and compositing tree according to another example of 
the further embodiment; 

Fig. 1 1 illustrates the effect on the image of Fig. 10 of moving region A; 

Fig. 12 illustrates an image and compositing tree according to still another example 
of the further embodiment; 

Fig. 13 illustrates the effect on the image of Fig. 12 of moving region A; 

Fig. 14 illustrates the effect on the image of Fig. 12 of moving region B; and 

Fig. 15 illustrates those nodes in a compositing tree which need to have their region 
groups updated if leaf nodes B and H change; 

Fig. 16 illustrates a region and its x and y co-ordinates; 

Fig. 17 illustrates two regions and their x and y co-ordinates; 

Fig. 18 illustrates an image and compositing tree according to still another example 
of the further embodiment; 

Fig. 19 illustrates an apparatus upon which the preferred embodiments is 
implemented; 

Fig. 20 depicts the result of a variety of compositing operators useful with the 
present invention; 
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Fig. 21 illustrates regions formed by combining two circles with non-grid-aligned 
regions; 

Fig. 22 illustrates improved regions formed by combining two circles with grid- 
aligned regions; 

5 Fig. 23 is a flowchart showing a method of creating an image in accordance with 

the preferred embodiments; 

Fig. 24 is a flowchart showing a method of creating a series of images in 
accordance with the further embodiment of the present invention; and 

Appendix 1 is a listing of source code according to the present invention 

10 Detailed Description 

1.0 Underlying Principles 

The basic shape of operands to compositing operators in most current systems is the 
rectangle, regardless of the actual shape of the object being composited. It is extremely 
easy to write an operator which composites within the intersection area of two bounding 

15 boxes. However, as a bounding box typically does not accurately represent the actual 
bounds of a graphical object, this method results in a lot of unnecessary compositing of 
completely transparent pixels over completely transparent pixels. Furthermore, when the 
typical make-up of a composition is examined, it can be noticed that areas of many of the 
objects are completely opaque. This opaqueness can be exploited during the compositing 

20 operation. However, these areas of complete opaqueness are usually non-rectangular and 
so are difficult to exploit using compositing arguments described by bounding boxes. If 
irregular regions are used for exploiting the opaque objects, then these regions could be 
combined in some way to determine where compositing should occur. Furthermore, if 
any such region is known to be fully transparent or fully opaque, further optimisations are 

25 possible. 

Most current systems fail to exploit similarities in composition between one frame 
and the next. It is rare for everything to change from frame to frame and therefore large 
areas of a compositing tree will remain unchanged. An example of this is where a 
cartoon type character comprising multiple graphical objects is rendered on a display. If, 

30 for example, the character spilt some paint on its shirt in the next frame, then it is not 
necessary to render the entire image again. For example, the head and legs of the 
character may remain the same. It is only necessary to render those components of the 
image that have been altered by the action. In this instance, the part of the shirt on which 
the paint has been spilt may be re-rendered to be the same colour as the paint, whilst the 

35 remainder of the character stays the same. Exploiting this principle may provide large 
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efficiency improvements. If incremental changes are made to the compositing tree, then 

only a reduced amount of updating is necessary to affect the change. 

Many current graphical systems use what is known as an immediate mode 

application program interface (API). This means that for each frame to be rendered, the 

complete set of rendering commands is sent to the API. However, sending the complete 

set of rendering commands to the API is somewhat inefficient in a compositing 

environment, as typically, large sections of the compositing tree will be unchanged from 
one trame to the next, but would be completely re-rendered anyway in immediate mode. 

The preferred embodiment, on the other hand, is considered by the present inventors to be 

best described as a retained mode API. Retained mode means that instead of providing 

the complete compositing tree on a per-frame basis, the user provides an initial 

compositing tree, and then modifies it on a per-frame basis to effect change. Changes 

which can be made to the tree include geometrically transforming part or all of the tree, 

modifying the tree structure (unlinking and linking subtrees), and modifying attributes 

(eg: color) of individual nodes. Note that such modifications may not necessarily mean 

that the tree structure, for example as seen in Fig. 1, will change where only the attributes 

of an individual node have been modified. 

The rendering operation of the preferred embodiments is a combination of a number 
of techniques and assumptions which combine to provide high quality images and high 
frame rates. Some of the contributing principles are: 

(1) The use of irregular regions to minimise per-pixel compositing. For example, 
if one graphical object is on top of another, then pixel compositing is only needed inside 
the area where the two objects intersect. Having the ability to use irregular regions gives 
the ability to narrow down areas of interest much more accurately. 

(ii) An assumption is made that in the transition from one frame to the next, only 
part of the tree will change. This can be exploited by caching away expensive-to- 
generate information regarding the composition so that it can be re-used from one frame 
to the next. Examples of expensive-to-generate information are - regions of interest 
(boundaries of areas of intersection between objects etc); pixel data (representing 
expensive composites etc); and topological relationships between objects. 

(iii) If an opaque object is composited with another object using the OVER 
operator, then the opaque object completely obscures what it is composited onto (inside 
the opaque objects area). This is a very useful property because it means that no 
expensive pixel compositing is required to achieve the output pixel within the area of 
overlap. (The pixel value is the same as that at the equivalent spot on the opaque object). 
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Opaque objects induce similar behaviour in most of the compositing operators. 
Therefore, the preferred embodiments attempts to exploit opaque areas as much as 
possible. 

Fig. 23 is a flowchart showing a method of creating an image in accordance with 
5 the preferred embodiments of the present invention. The image is formed by rendering 
graphical objects to be composited according to a compositing expression. The process 
begins at step 2301, where a space in which the object boundary outlines are defined is 
divided into a number of mutually exclusive regions. Each of the regions is defined by at 
least one of the predetermined region boundary outlines or parts thereof. The process of 

10 dividing the space into a number of regions and manipulating those regions is described 
in detail particularly with reference to section 2.3 below. Section 2.3 includes two 
pseudocode listings which describe step 2301 for the "OVER" and "IN" compositing 
operations. The process continues at step 2303, where one of the regions is selected and 
examined to determine which objects contribute to the region. At the next step 2305, a 

15 compositing expression corresponding to the selected region is modified on the basis of 
the contribution of each of the objects within the region to form an optimised compositing 
expression for that region. The process of examining each of the regions and modifying 
the compositing expression is described in detail particularly with reference to section 2.4 
below. Section 2.4 includes two pseudocode listings which describe steps 2303 and 2305 

20 for the "OVER" and "IN" compositing operations. The process continues at step 2307, 
where image data for the selected region is rendered. At the next step 2309, a check is 
carried out to determine if any more regions require processing. If more regions require 
processing, then the process continues to step 2303, where another region is selected. 
Alternatively, if all of the mutually exclusive regions have been processed, the process 

25 concludes at step 231 1, where region data for all of the regions is combined to form one 
image. Steps 2307, 2309 and 231 1 are described in detail with reference to section 2.6, 
below, which includes a pseudocode listing. 
2.0 Basic Static Rendering 

Static Rendering deals with the problem of generating a single image from a 

30 compositing tree as quickly as possible. Some of the pixel compositing methods of the 

preferred embodiments will be explained using a static rendering example. 

An example of a simple compositing tree which consists of leaf node objects and 

only using the "OVER" operator is shown in Fig. 2. Conventionally, each node is 

considered to be conceptually infinite in extent. One method to construct the final image 

35 is to apply the compositing equation (((D OVER B) OVER C) OVER (A OVER E)) at 
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every pixel of the output image. However, this is quite an inefficient method. 

A composition can generally be subdivided into a number of mutually exclusive 
irregular regions. The above compositing expression may be simplified independently 
within each region. In the example of Fig. 2, A, C and E represent opaque objects. B and 
5 D, on the other hand are partially transparent. Fig. 3 shows the different regions (1-10) 
produced using the five objects which exist in the example, and the compositing expres- 
sion which would be used to generate the pixel data for each specific region. 

The compositing expressions provided in Fig. 3 make no attempt to exploit the 
properties of the object's opacity. If these properties are used to simplify the compositing 
10 expressions for each region, the expressions of Fig. 4 are obtained resulting in a 
simplification of the rendering of regions 2, 3, 5, 6, 7, 8 and 9 compared with Fig. 3. 
These simplified compositing expressions would result in far fewer pixel compositing 
operations being performed to produce the final picture. 

Fig. 4 represents the region subdivision for the root of the compositing tree. 
15 However, every node in the compositing tree can itself be considered the root of a 
complete compositing tree. Therefore, every node in the compositing tree can have 
associated with it a group of regions which together represent the region subdivision of 
the subtree of which the node is the root. Region subdivision provides a convenient 
means of managing the complexity of a compositing tree and an efficient framework for 
20 caching expensive data. 

Using the principles noted above, a compositing expression can be simplified 

dependent upon whether the graphical objects being composited are wholly opaque, 
wholly transparent or otherwise (herewith deemed "ordinary"). 

Table 1 shows how the compositing operations of Fig. 20 can be simplified when 

25 one or both operands are opaque or transparent. 

TABLE 1 



Expression 


A's opacity 


B's opacity 


Optimised 


AoverB 


Transparent 


Transparent 


neither 




Transparent 


Ordinary 


B 




Transparent 


Opaque 


B 




Ordinary 


Transparent 


A 




Ordinary 


Ordinary 


AoverB 




Ordinary 


Opaque 


AoverB 




Opaque 


Transparent 


A 




Opaque 


Ordinary 


A 




Opaque 


Opaque 


A 


AroverB 


Transparent 


Transparent 


neither 
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Transparent 


Ordinary 


B 




Transparent 


Opaque 


B j 




Ordinary 


Transparent 


A 1 




Ordinary 


Ordinary 


BoverA ! 


• 


Ordinary 


Opaque 


B 




Opaque 


Transparent 


A 




Opaque 


Ordinary 


BoverA 




Opaque 


Opaque 


B 


AinB 


Transparent 


Transparent 


neither 




Transparent 


Ordinary 


neither 




Transparent 


Opaque 


neither 




Ordinary 


Transparent 


neither 




Ordinary 


Ordinary 


AinB 




Ordinary 


Opaque 


A 




Opaque 


Transparent 


neither 




Opaque 


Ordinary 


AinB 




Opaque 


Opaque 


A 


ArinB 


Transparent 


Transparent 


neither 




Transparent 


Ordinary 


neither 




Transparent 


Opaque 


neither 




Ordinary 


Transparent 


neither 




Ordinary 


Ordinary 


BinA 




Ordinary 


Opaque 


BinA 




Opaque 


Transparent 


neither 




Opaque 


Ordinary 


B 




Opaque 


Opaque 


B 


AoutB 


Transparent 


Transparent 


neither 




Transparent 


Ordinary 


neither 


1 


Transparent 


Opaque 


neither 




Ordinary 


Transparent 


A ! 




Ordinary 


Ordinary 


AoutB | 




Ordinary 


Opaque 


neither 




Opaque 


Transparent 


A l| 




Opaque 


Ordinary 


AoutB 




Opaque 


Opaque 


neither 


AroutB 


Transparent 


Transparent 


neither 




Transparent 


Ordinary 


B 




Transparent 


Opaque 


B 




Ordinary 


Transparent 


neither 




Ordinary 


Ordinary 


BoutA 




Ordinary 


Opaque 


BoutA 




Opaque 


Transparent 


neither 




Opaque 


Ordinary 


neither 




Opaque 


Opaque 


neither 


AatopB 


Transparent 


Transparent 


neither 




Transparent 


Ordinary 


B 




Transparent 


Opaque 


B 




Ordinary 


Transparent 


neither 
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Ordinary 
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Ordinary 


Opaque 


AxorB 




Opaque 


Transparent 


A 




Opaque 


Ordinary 


AxorB 




Opaque 


Opaque 


neither 



2.1 Basic Data Model 

Associated with every node in a compositing tree is a group of mutually exclusive 
regions which together represent the non-transparent area of the node. It should be noted 
that the region descriptions that the preferred embodiments uses are generally not pixel 
accurate. A region may in fact contain some transparent pixels. However, any point 
lying outside of all the regions at a node is certain to be transparent. The set of the 
mutually exclusive regions at a node is known as a region group. A leaf node region 
group may contain only one or two regions. The region group at the root of the tree may 
contain hundreds of regions. Each region in a region group contains the following basic 
data: 

(i) A Region Description is a low-level representation of the boundaries of the 
region. The region descriptions of all the regions in a region group must be mutually 
exclusive (non-intersecting). However, the preferred embodiments is not limited to using 
axis-parallel (ie: every side parallel or perpendicular to a scan line of an output device) 
region descriptions. The preferred embodiments allows region descriptions which more 
closely represent arbitrary shaped regions. 

(ii) A Proxy is some means of caching the pixel data resulting from applying the 
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operations specified by the compositing expression at every pixel inside the region 
description. A proxy can be as simple as a 24-bit colour bitmap, or something much 
more complicated (such as a run-length encoded description). Fundamentally, a proxy 
simply has to represent pixel data in some way which makes it efficient to retrieve and 
5 use. 

Every region group also contains a region description which is the union of all the 
region descriptions of the regions in the region group. The region description essentially 
represents the entire coverage of the region group. 
2.2 Region Descriptions and Region Arithmetic 
10 The region arithmetic and data structure of the preferred embodiments has the 

following properties: 

-to allow the representation of complex regions, including convex regions, concave 
regions and regions with holes. This is necessary so that a region will be reasonably able 
to follow the geometry of the graphic object it represents; 
15 -is space efficient. In a complicated composition there will be many regions. For 
memory efficiency, it is therefore preferable that the cost of storing these regions is 
reasonably small; 

-the region arithmetic should support basic set operations - Union, Intersection and 
Difference; 

20 -the above-noted basic operations should be efficient in terms of speed. In a complex 
compositing tree, it is possible that a large amount of region arithmetic will be 
undertaken. A poor implementation of region arithmetic could lead to the time taken by 
region arithmetic being greater than the time saved from the reduction in per-pixel 
compositing; 

25 -it is advantageious if the region description can be geometrically translated efficiently. 
In cases where a graphic object is translated, the graphic objects associated regions can 
then be translated quickly; and 

-it is sometimes helpful to be able to quickly compare two regions to determine if they are 

the same. It is not necessary to obtain any other statistics on their similarity, simple 

30 equality is all that is required. 

Two conventional region description techniques were considered and rejected for the 
preferred embodiment. These were- 

Polygons: A polygon can be used to represent almost any object, the disadvantage 
of using a polygon, however, is that a polygon's generality makes implementing the set 
35 operations slow and inefficient. 
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Qu ad trees: Using quadtrees, set operations are easy to implement and are quite 
efficient. In addition, they can represent a wide variety of regions given sufficient 
granularity (all edges in a quadtree have to be axis-parallel). Their major failing is that all 
quadtrees must be aligned on the same grid (granularity). This means that it is impossible 
to simply translate a quadtree by an arbitrary amount. Unless that amount is a multiple of 
the underlying grid size, the quadtree will need to be recalculated from the object it 
describes (otherwise it will keep growing). Therefore, quadtrees are not suitable in 
application domains where geometric translation is a frequent operation. 

The region description data structure of the preferred embodiments can be 
understood by imagining that along a vertical line every coordinate has a state which is 
one of either inside or outside the region. The data structure stores those y co-ordinates at 
which some change of state between inside and outside occurs. For each such y co- 
ordinate, the data contains spans of coordinates each of which toggles the state of every 
vertical line running through the data. Each span of x co-ordinates is called a run. The 
sequence of runs associated with a y co-ordinate is called a row. For example, the region 
of Fig. 16 could be described by the following: 

row y = 10 : x = 10, x = 100 

row y = 100 : x = 10, x =100 
Similarly, the regions of Fig. 17 could be described by the following: 

row y = 10 : x = 10, x =100 

row y = 30 : x = 30, x = 70 

row y = 70 : x = 30, x = 70 

row y = 100 : x+10, x= 100 
The data representing a region is represented by an array of integer values. There are two 
"special" values - 

A beginning-of-row marker. Indicates that the next integer in the 
sequence will represent a y coordinate. 

Stands for End-of-Region. Indicates that the region description has 
finished. 

All other values represent x or y coordinates. The x coordinates in a row represent 
runs. The first two co-ordinates represent a run, then the next two represent the next run 
and so on. Therefore, the x coordinates in a row should always be increasing. Also, there 
should always be an even number of x-coordinates in a row. The region data stream for 
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Fig. 17 is shown below. 

R_NEXT_IS_Y 10 10 100 
R_NEXT_IS_Y 30 30 70 
5 R_NEXT_IS_Y 70 30 70 

R_NEXT_IS_Y 100 10 100 
R_EOR 

The preferred embodiments also contains the bounding box of the region, as this is 
useful in certain set operations. 
10 As seen in Fig. 6, if two region descriptions are combined using a Union operation, 

then the resultant region description will describe an area in which either region 
description is active. 

As seen in Fig. 7, if two region descriptions are combined using the Intersection 
operation, then the resultant region description will describe an area in which both the 
15 region descriptions are active. 

If two region descriptions are combined using the Difference operation, then the 
resultant region will describe an area in which only the first region is active, as seen in 
Fig. 8. 

20 2.3 Constructing Region Groups: 

2.3.1 Constructing Leaf Node Region Groups 

A region group for a leaf node will typically contain one or more regions, which 
together fully contain the non-transparent area of the graphical object represented by the 
leaf node. Typically, the non-transparent area is divided into regions where each region 

25 has some property that facilitates optimization. For example, the non-transparent area of 
some graphical object can be divided into two regions, one fully opaque and the other 
with ordinary opacity. The above mentioned compositing optimizations would apply 
where the opaque region is composited. 

Alternatively, the leaf node could be subdivided based on some other attribute. For 

30 example, a leaf node could be divided into two regions, one representing an area of 

constant colour, the other representing blended colour. Areas of constant colour may be 
composited more efficiently than areas with more general colour description. 

2.3.1.1 Region Formation and Phasing 

When creating regions, it is not always beneficial that region boundaries follow 

35 graphical object boundaries precisely. What is important is that any property that 
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facilitates optimization is valid at all points within a region said to have that property. 

For example, an opaque circle could be covered exactly by one circular region which is 

classified as opaque, or by two approximate regions, one fully opaque octagonal region 

inscribed in the circle, and one annular octagonal region of ordinary opacity that includes 

5 the remainder of the circle plus some area exterior to the circle. 

There is typically a trade-off between how closely region boundaries follow 

graphical object boundaries and the benefits obtained. If region boundaries follow object 

boundaries very closely, a lot of work is usually involved in creating the region 

boundaries and in performing intersections and differences of regions (the reasons for 
10 needing to perform such operations are explained in later sections). However, if region 

boundaries are too approximate, they may either include large areas that are outside the 

objects' boundaries, resulting in too much unnecessary compositing, or they may fail to 

include large areas where known properties lead to optimization. 

One approach, as illustrated in the appendix, is to limit region boundaries to 

15 sequences of horizontal and vertical segments. Using this approach, the typical segment 

size is chosen so that there is neither too much detail so that the region operations are 

overburdened, nor too much approximation to result in wasted compositing or insufficient 

optimization. 

One method to improve the efficiency of region operations is to choose as many, as 
20 is practical, of the horizontal and vertical segments of substantially all region boundaries 
to be in phase. In other words, the horizontal and vertical segments are to be chosen from 
the horizontal and vertical lines of the same grid. The grid need not be regularly spaced, 
nor have the same spacing horizontally and vertically, although typically it will. 

Choosing the horizontal and vertical segments from the horizontal and vertical lines 
25 of the same grid improves the efficiency of region operations by seeking to keep all 
region boundary detail to the level of detail contained in the underlying grid. Without 
constraining the majority of region boundary segments to a grid, region operators such as 
difference and intersection tend to produce a lot more fine detail. For example, in Figure 
21, two circles 901 and 902 are shown with respective regions 903 and 904 that are not 
30 grid-aligned. These circles are overlapped yielding difference regions 905 and 907, and 
intersection region 906. In Figure 22, the same circles 901 and 902 have regions 913 and 

914 that are aligned to grid 910. These circles are overlapped yielding difference regions 

915 and 917 and intersection region 916. It can be seen in this example that the grid- 
aligned regions yield less detailed results at the expense of slightly less efficient region 

35 coverage. Regions 905, 906 and 907 together contain a total of sixty segments, while 
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regions 915, 916 and 917 together contain only fifty-two. 

2.3.2 Creating Binary Region Groups 

The region groups of binary nodes in the compositing tree on the other hand are the 

result of combining the region groups of their child nodes. It will now be explained how 
region groups are combined to form new region groups. In this section, for simplicity 

only "OVER" and "IN" binary nodes will be dealt with. The operations required for 

binary nodes representing other compositing operators can easily be inferred from 

combining the "OVER" and "IN" cases in various ways. 

For the sake of clarity, the method of the preferred embodiments is initially 
described without reference to optimization based properties such as opacity. 

The following notation will be beneficial when considering binary region group 
creation: 



Notation 



RG1 


The region group of the binary node's left child 


RG2 


The region group of the binary node's right child 


RG 

RGl-Hirgn 
RG2-+urgn 
RG->urgn 


The region group of the binary node. It is this region group 

that is being initialised 
The region description representing the union of all RGl's 

region descriptions (RGl's coverage region). 
The region description representing the union of all RG2's 

region descriptions (RG2's coverage region). 
The union of all RG's region descriptions (to be initialised) 

(RG's coverage region) 


rgli 


The current region in RG1 


rg2j 


The current region in RG2 


rgli-»rgn 


rgli's region description 


rg2j->rgn 


rg2j's region description 


rgli-»proxy 


rgli's proxy 


rg2j-»proxy 


rg2j's proxy 



2-3.2.1 Constructing "OVER" Region Groups 

When constructing "OVER" region groups, only areas where the contributing 
region groups intersect need to be composited. Areas where one operand does not 
overlap the other involve no compositing. The method is broken into three iterative steps. 
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First, the coverage region of the region group of the binary node that is being initialised 
(RG->urgn) is made equal to the union of the coverage regions of the binary nodes left 
child (RGl->urgn) and the binary node's right child (RG2-»urgn). Then, for each region 
rgi in RG1, the difference (diffjgn) between that region and RG2 f s coverage region 
5 (RG2->urgn) is then calculated. If the difference (diff_rgn) is non-empty then a new 
region with diffrgn as its region description is added to RG. The proxy of this new 
difference region can be the same as the proxy rglj. No compositing is required to 
generate it. The difference regions between RG2 , s regions and RGl's coverage region are 
similarly constructed and added to RG. Finally, the intersection (interrgn) between each 

10 region rglj in RGI and each region rg2j in RG2 is calculated. If the result of this 
intersection is non-empty, then a new proxy (new_p) is created by compositing rglj's 
proxy with rg2/s proxy using the over operation with the inter_rgn. A new region is then 
added to RG with inter_rgn as its region description and new_p as its proxy. The method 
of constructing "OVER" region groups in accordance with the preferred embodiment is 

15 described below using pseudo-code. 

RG-Hjrgn = RG1-HJrgn union RG2->urgn 
FOR i = 0 TO number of regions in RG1 DO 
diff_rgn = rg1|->rgn difference RG2-»urgn 
IF diff_rgn is non-empty THEN 

20 ADD to RG a new region with diff_rgn as its region description and 

rg1i->proxy as its proxy. (*) 
END IF 

FOR j = 0 TO number of regions in RG2 DO 
inter_rgn = rg1j-*rgn intersection rg2j->rgn 
25 IF interjrgn is non-empty THEN 

create new proxy new_p initialised to OVER of rg1 r->proxy and 
rg2j^proxy inside inter_rgn. 

ADD to RG a new region with inter_rgn as its region description 
and new_p as its proxy. (+) 
30 END IF 

END DO 
END DO 

FOR j = 0 TO number of regions in RG2 DO 
diff_rgn = rg2j->rgn difference RG1-»urgn 
35 IF diff_rgn is non-empty THEN 
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ADD to RG a new region with diff_rgn as its region description and 
rg2j->proxy as its proxy. (*) 

END IF 
END DO 

5 

The regions added by the ADD operations marked with asterisks (*) above are 
termed difference regions since their shape is the result of a difference operation. Such 
regions are very cheap computationally because their proxies require no compositing. 
The only work involved is the administrative overhead of adding a new region to the 
10 region group and the cost of the difference operation itself. In the preferred embodiment, 
a proxy is inherited from the region (in one of the child region groups) on which it is 
based. It can be seen that proxies which originate low in the compositing tree can be 
propagated upwards towards the root with minimal overhead (both in terms of speed and 
memory) by the use of difference regions. 
I "* # 15 The regions added by the ADD operation marked with the plus (+) are termed 

intersection regions. This is because their shape is the result of an intersection operation. 
The proxies of such regions are more expensive to generate than difference regions 
because they involve per-pixel compositing operations to be done within the area defined 
by the intersection. The more fidelity granted the region descriptions, the greater the 
20 saving in pixel processing costs, at the cost of a greater administrative overhead (more 
complex regions require longer to intersect etc). 

Figs. 8A to 8D provide a simple example of combining "OVER" region groups 
using the above method. The region group resulting from the combination contains 5 
regions, 3 difference regions and 2 are intersection regions. Fig. 8A represents two 
25 region groups RG1 and RG2 which are to be combined. RG1 contains two regions 81 
and 82, whereas RG2 only contains a single region 83. As seen in Fig 8B, for each region 
in RG1, RG2's region coverage is subtracted from the corresponding region in RG1. If 
the resultant region is non-empty, the resultant region becomes a region in the new region 
group. In this example both regions 81 and 83 produce non-empty difference regions 84 
30 and 85 respectively. For each region in RG2, RGl's region coverage is subtracted from 
it, as seen in Fig 8C. In this example difference region 86 is produced. Finally, every 
region in RG1 is intersected with every region in RG2, as seen in Fig 8D. Any non- 
empty region becomes a region in the new region group. In this example, regions 81 and 
83 produce 87. Further, regions 82 and 83 produce 88. 
35 2.3.2.2 Constructing "IN" Region Groups 
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The properties of the "EN" operator lead to the fact that an "DM" binary region group 
only produces pixel data in the region of intersection between the two contributing region 
groups. Essentially, when compared to the algorithm used for "OVER" region groups, 
only intersection regions are generated. Therefore, for each region rglj of RG1, and for 
5 each region rg2j of RG2 the intersection (interjgnjj) between rglj and rg2j is calculated. 
If the intersection is non-empty then a new proxy (new_p) is created by compositing 
rgl/s proxy with rg2 J , s proxy using the "in" operation within inter_rgn s . A new region is 
then added to RG with inter_rgn as its region description and new_p as its proxy. The 
pseudocode for the method of constructing "IN" region groups according to the preferred 
10 embodiment is provided below: 

RG->urgn = RGI^urgn intersection RG2-Hjrgn 
FOR i = 0 TO number of regions in RG1 DO 

FOR j = 0 TO number of regions in RG2 DO 
inter_rgn = rg1r->rgn intersection rg2j->rgn 
15 IF inter_rgn is non-empty THEN 

create new proxy new_p initialised to IN of rgl^proxy and 
rg2j^proxy inside inter_rgn. 

ADD to RG a new region with inter_rgn as its region description 
and new_p as its proxy. (+) 
20 END IF 

END DO 
END DO 



The major difference between the "IN" and the "OVER" cases is that the "OVER" 
25 case generates difference regions while "IN M does not. In the example demonstrated by 
Figs. 8A to 8D, only new regions 97 and 98 would be generated, as these are intersection 
regions. Difference regions 94, 95 and 96 would not be generated using "EN". 

Using Table 2 below and the pseudocode examples of "OVER" and "IN", the 
relevant code for other compositing operators can be derived. 
30 2.3.2.3 Constructing Region Groups of Other Compositing Operators 

Other compositing operators typically generate the same intersection regions as the 
"OVER" and "IN" cases do. However, they typically differ from one another (as indeed 
from "OVER" and "IN") in what difference regions they generate. This is dependent on 
the particular properties of each compositing operator. Table 2 summarises which 
35 difference regions are generated for some commonly used compositing operators. 
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TABLE 2 



Compositing Operator 


Generate Diff Rgns from 
RG1 ? 


Generate Diff Rgns from 
RG2? 


Over 


Yes 


Yes 


In 


No 


No 


Out 


Yes 


No 


Atop 


No 


Yes 


Xor 


Yes 


Yes 


Plus 


Yes 


Yes 
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2.4 Optimising using Opaque Areas 

The preferred embodiments stores within each region a flag indicating whether the 
5 pixel data in the region proxy is completely opaque. It is therefore possible to reduce the 
number of per-pixel compositing operations by exploiting the effect opaque operands 
have on the compositing operators. 

2.4.1 Opaque Area Optimisation for "Over" Region Groups 

If an opaque region is "OVER" another region, then there is no need to compute the 

10 result of the composite, as no part of the right operand region's proxy is visible through 
the left operand's opaque proxy. In the preferred embodiment, the resultant region is 

made to reference the right operand's proxy, which has the same effect as actually doing 

the composite. 

The method of opaque area optimisation for "OVER" region groups is a slightly 
15 modified version of the "OVER" region group construction method provided previously. 
The only difference is that when calculating the intersection region of the current region 
in RG1 and each region of RG2, a check is carried out to see whether the current region 
in RG1 is opaque. If this is the case, then the proxy of the newly calculated region 
(new_p) will be the proxy of the current region in RG1. 
20 The method is illustrated using the following pseudocode : 

RG->urgn = RG1-Hjrgn union RG2-»urgn 
FOR i = 0 TO number of regions in RG1 DO 
diff_rgn = rg1|->rgn difference RG2->urgn 
25 IF diff_rgn is non-empty THEN 

ADD to RG a new region with diff_rgn as its region description and 
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rg1i-»proxy as its proxy. (*) 
END IF 

FOR j = 0 TO number of regions in RG2 DO 
inter_rgn = rg1j->rgn intersection rg2j-»rgn 
5 IF inter_rgn is non-empty THEN 

IFrgljis OPAQUE THEN 
new_p = rg1j-»proxy 
ELSE 

create new proxy new_p initialised to OVER of rgl^proxy 
10 and rg2j->proxy inside inter_rgn. 

END IF 

ADD to RG a new region with interjgn as its region description 
and new_p as its proxy. (+) 
END IF 
15 END DO 

END DO 

FOR j = 0 TO number of regions in RG2 DO 

diff_rgn = rg2j-»rgn difference RG1->urgn 

IF diffjgn is non-empty THEN 
20 ADD to RG a new region with diff_rgn as its region description and 

rg2]->proxy as its proxy. (*) 

END IF 
END DO 

25 2.4.2 Opaque Area Optimisation for "IN" Region Groups 

If a region is "IN" an opaque region, then according to the properties of the "IN" 

operator, the resultant pixel data is the same as that of the left operand. This can be 

achieved by having the resultant region simply reference the proxy of the left operand. 
The method of the preferred embodiments is a slightly modified version of the "IN" 

30 region group construction method provided previously. The only difference is that when 
calculating the intersection region of the current region in RG1 and each region of RG2, a 
check is carried out to see whether the current region in RG2 is opaque. If this is the 
case, then the proxy of the newly calculated region (new_p) will be the proxy of the 
current region in RG1. 

35 The technique is illustrated using the following pseudocode: 
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RG-*urgn = RG1-»urgn intersection RG2-Hjrgn 
FOR i = 0 TO number of regions in RG1 DO 

FOR j = 0 TO number of regions in RG2 DO 
5 inter_rgn = rg1j-»rgn intersection rg2j-»rgn 

IF inter_rgn is non-empty THEN 
IF rg2j is OPAQUE THEN 
new_p = rg1j-»proxy 
ELSE 

10 create new proxy new_p initialised to IN of rg1j-»proxy and 

rg2j->proxy inside inter_rgn. 

END IF 

ADD to RG a new region with inter_rgn as its region description 
and new_p as its proxy. (+) 
15 END IF 

END DO 
END DO 

2.5 Initialising the Entire Tree 

20 The entire compositing tree can be initialised by using the above-described method 

of the preferred embodiments on every binary region group in the tree. A node cannot be 

initialised until its children have been initialised. Therefore the process simply starts at 

the bottom of the tree and works its way up towards the root. The process first checks to 
see if the current node is a leaf node. If this is the case, then a leaf node region group is 

25 constructed. However, in the case that the current node is a binary node then a binary 

node region group is constructed using the method of the preferred embodiments outlined 

in sections 2.4.1 and 2.4.2. The following pseudocode outlines a method for initialising 

all the region groups of the tree. The method utilises a recursive function, which is called 

passing the root of the tree as an argument. 

30 

tree_init(node : tree ptr) 
BEGIN 

IFnode is a leaf node THEN 

CONSTRUCT leaf node region group 
35 ELSE 
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tree_init(node-»left) 
tree_init(node-» right) 

CONSTRUCT binary node region group by combining region groups of 
the left and right children 
5 END IF 

END tree init 



• • •• 



2.6 Constructing the Resultant Image 

Once the compositing tree has been initialised, the region group at the root of the 
10 tree contains a group of zero or more regions which together represent the partitioning of 
the resultant image into areas which differ in the way the image data was generated. 
Some of the regions 1 proxies can refer to image data directly from leaf nodes of the tree, 
having not required any compositing. Other regions, on the other hand, may have proxies 
which are the result of compositing operations. If a single resultant image is required, 
15 such as an image stored in a pixel buffer, this can be achieved by copying the image data 
from each region's proxy to the pixel buffer within the area corresponding to the region. 
The process is demonstrated in the pseudocode provided below, which is generalised and 
able to restrict the construction of the final image to any nominated update region. 



20 constructjmage 
( 

outputjmage : pixel data ptr, 
urgn : region description 

) 

25 BEGIN 

FOR i = 0 TO number of region in RG DO 
int_rgn = rg,->rgn intersection urgn 
IF intj-gn is non-empty THEN 

COPY image data from rg^proxy to outputjmage inside int_rgn 
30 END IF 

END DO 
END constructjmage 

3.0 Dynamic Rendering 

35 Dynamic Rendering refers to the problem of generating multiple successive images. 
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Given a compositing tree, it is possible to generate it's region groups (containing regions 
and proxies) using the method described above. A further embodiment to the above- 
mentioned method, which supports dynamic rendering is described below. The 
compositing tree represents an image. Changes to the tree can be made to make the tree 
5 represent a new image. The tree's region groups (and tree region description and proxies) 
are updated to reflect the modified tree. Performance is improved by exploiting 
commonality between the two images. An example will illustrate the techniques and 
terminology of the further embodiment. 

Fig. 3 shows the region subdivision and the respective compositing expressions 

10 (advantage is not taken of opacity) for the simple compositing tree. Consider therefore 
the situation in which object A moves by a small amount relative to the other objects. 
Some regions in the region group at the root of the tree will be affected by A moving. 

If opaque case optimisations are ignored, the regions with compositing expressions 
which include A will be significantly affected by A moving. The region numbers which 

15 are so affected are 2, 3, 5 and 6. When updating the region group at the root of the tree, 
those regions will need both their region descriptions and their proxies completely 
recalculated. This situation is known in the further embodiment as primary damage. Any 
region whose compositing equation includes an object which has changed in some way, 
may be said to suffer primary damage. 

20 Regions that abut regions which have A in their compositing expression are also 

effected by A moving, though not as severely as those regions with primary damage. In 
the example, these other affected regions are 1, 4, 7 and 8. When updating the region 
group at the root of the tree, these regions will need their region descriptions recalculated. 
However, their proxies will only need to be recalculated in areas of the new region which 

25 were not included in the corresponding earlier region. This situation is known in the 
further embodiment as secondary damage. Generally, secondary damage is incurred if an 
object upon which a region's boundary (but not content) depends, changes in some way. 

In order to reduce the per-frame update cost, it is important to reduce, as far as is 
practicable, the amount of work necessary, both in terms of per-pixel operations, but also 

30 in terms of region group operations. The concepts of primary and secondary damage are 
a way of facilitating this. If the further embodiment is able to accurately determine the 
minimum set of regions throughout all the compositing tree which have some kind of 
damage, then obviously the amount of work being done is reduced. 

Fig. 24 is a flowchart showing a method of creating a series of images in 

35 accordance with a further embodiment of the present invention. Each member of the 
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series of images is related to a preceding member. The images are formed by rendering a 
number of graphical objects to be composited according to a hierarchical compositing 
tree representing a compositing expression. Each node of the hierarchical compositing 
tree represents a component of at least one of the images and each of the objects has a 

.5 predetermined outline. The process begins at step 2401, where a hierarchical 
compositing tree representing a first image is accessed. At the next step 2403, for each 
node of hierarchical compositing tree, the component image space is subdivided into a 
number of mutually exclusive regions. The process continues at step 2405, where each of 
the mutually exclusive regions is examined and internodal dependency information is 

10 created. The data structure of the internodal dependency information and the process for 
creating it are described in sections 3.1 to 3.9 below. At the next step 2407, the first 
image is rendered according to the hierarchical structure. The process continues at step 
2409, where the image changes resulting in changes to the hierarchical compositing tree. 
At the next step 2411, the dependency information is examined to determine which 

15 regions have been affected by the changes to the hierarchical compositing tree. The 
process continues at the next step 2413, where affected regions are updated. At the next 
step 2415, the internodal dependency information is updated to reflect the changes to the 
hierarchical compositing tree. The process of examining and updating the regions is 
described in sections 3.6 to 3.9, below. In particular, section 3.9 includes a pseudocoding 

20 listing which illustrates a method for updating a binary "OVER" region. The process 
continues at step 2417, where the changed portions of the first image are rendered 
according to the hierarchical compositing tree to produce the updated image. Only those 
regions affected by the change are rendered at step 2417. 

25 3.1 Basic Data Model 

The data model used for static rendering, consisting as it does of a region 
description and a proxy, is insufficient for use in dynamic rendering. This is because, for 
primary and secondary damage to be determined, it must be possible to associate regions 
of the same content between frames. To support the association of regions of the same 

30 content, some extra information is required in each region in a region group. Therefore, 
each region in a region group now contains the following data: 

(i) A Region Description: A low-level representation of the boundaries of the 
region. The region descriptions of all the regions in a region group must be mutually 
exclusive (non-intersecting, non-overlapping). 

35 (ii) A Proxy: Some means of caching the pixel data resulting from applying the 
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operation specified by the compositing expression at every pixel inside the region 
description. A proxy can be as simple as a 24-bit colour bit-map, or something much 
more complicated (such as a run-length encoded description). Fundamentally, a proxy 
simply has to represent pixel data in some way which makes it efficient to retrieve and 
5 use. 

(iii) A Contents Label: A contents label represents a unique symbolic expression 
that describes the method of construction of image data. The terms in the symbolic 
expression distinguish between different categorisations of a source of image data. 
Therefore, the region groups of two distinct leaf nodes in the compositing tree will 

10 contain regions which are labelled with distinct contents labels even if their actual image 
data is equivalent. The further embodiment uses a system of unique integers to represent 
contents labels. For example "23" could represent "(A over B) over C". 

(iv) A Flag Register: A general-purpose flag register used to store state during the 
region group update process. The exact flags stored here will be outlined in a later 

15 section. 

3.2 Contents Labels 

Leaf node region groups can contain multiple regions, with each region naturally 
having a unique contents label. For example, the region group of a leaf node in a 
compositing tree could contain a single region (tagged with a single contents label) 

20 representing the non-transparent area of the leaf node. Alternatively, the leaf node region 
group could contain two regions (each tagged with a different contents label), one 
representing the area of the leaf node which is completely opaque, the other representing 
the remaining non-transparent area. A leaf node can also be categorised even further, into 
an arbitrary number of regions (and associated contents labels). 

25 One way a contents label can be created is by assigning a new one to a region of a 

leaf node region group. Another way is taking other contents labels and combining them 
to create a new contents label that represents the symbolic expression that represents the 
combination of the contributing expressions. For example, if the contents label 
representing ((A comp B) comp C) is combined with the contents label representing (D 

30 comp E) then a new contents label will be created which represents (((A comp B) comp 
C) comp (D comp E)). 

As well as contents labels, dependency information is also required. Dependency 
information indicates how a given contents label is related to other contents labels, both 
in terms of how the contents of one region contribute to contents of other regions, and 

35 how change of a region boundary affect the boundary of other regions. The further 
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embodiment associates the following data with each contents label 

(i) Primary Dependency List: Each primary dependency is a contents label L' to 
which a contents label L directly contributes. In other words, a "primary dependency" is 
a contents label L' representing an expression which has been constructed by combining L 

5 and some other contents label. Each time contents labels are combined, the contents label 
for the combination is added to the primary dependencies of all contributors. 

(ii) Secondary Dependency List: Each secondary dependency is a contents label 
L" which can be indirectly affected if the image represented by the contents label L has 
changed in some way that affects it's boundary. Whenever contents labels are combined, 

10 a contributing contents label is added to the secondary steps of the continuation if and 
only if the compositing operator yields a difference region with said contributing contents 
label. Table 2 shows which of some commonly used operators yield difference regions 
for their left and right operands. In addition, for a combination of (A comp B), the 
secondary dependencies of the combination contents labels for all (A comp bj) and all (aj 

15 comp B) are added, where aj are the secondary dependencies of A and bj are the 
secondary dependencies of B. 

(iii) Property Information: Each contents label can represent contents which have 
properties which the compositing engine may be able to exploit. An example is that of 
opaqueness. If a contents label represents opaque content, then compositing that content 

20 could be much faster, as for certain operators, no per-pixel compositing operations would 
be required. 

3.3 Contents Label Implementation 

The further embodiment uses unique integers as contents labels, and stores a 
number representing the number of contents labels which currently exist. When a new 

25 contents label is created, the number is incremented and becomes the unique integer 
representing the contents label. This technique of assigning a contents label by 
monotonically incrementing an integer means that the contents labels' associated data 
structures can be stored in a one dimensional array which grows as more contents labels 
are added. A content label's data structure can be referenced simply by using the 

30 contents label as an index. When a leaf node contents label is created, the contents label 
is initialised to have no primary or secondary dependencies. If the current leaf node 
contents label is opaque, then a flag is set in content label i's properties. 

The pseudocode below illustrates the basic techniques used to create a new contents 
label which is not dependent on other contents labels (ie: a leaf node region group 

35 contents label): 
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Notation 



opaque 
cur_clab 
clabs 

clabs[i]->pri_deps 
clabs[i]->sec_deps 
clabs[i]->properties 



A flag passed to the function which indicates whether or not 

the contents label represents opaque content or not. 
A global integer which stores the last contents label created. 

A global array which stores the associated data structures of 

the contents label. 
A pointer to the head of content label i's primary 

dependency list. 
A pointer to the head of content label i's secondary 

dependency list. 
A flag register representing contents label i's properties. 



create_new_contents_label 
( 

opaque : boolean 
5 ) : RETURNS unsigned int 
BEGIN 

INCREMENT cur_clab. 
clabs[cur_clab]->pri_deps = NULL. 
clabs[cur_clab]->sec_deps = NULL. 
10 IF opaque THEN 

clabs[cur_clab]->properties = OPAQUE. 
ELSE 

clabs[cur_clab]->properties = 0. 
END IF 

15 RETURN cur_clab. 

END create_new_contents_label. 

Contents labels can also be created to represent the combination of existing contents 
labels. This is achieved in the further embodiment by a hash table which maps an 
20 operation and the contents labels of its operands (hashed together to create a key) to a 
single contents label representing the result. 

When a region is created which represents an intersection between two other 
regions (each with its own contents label), a new contents label is generated which is used 
to tag the new region. When this new contents label is generated, it must be added to the 
25 primary dependency lists of both its contributing operands. A secondary dependency list 
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which depends on the secondary dependencies of the two contributing contents labels as 
well as the properties of the compositing operator must also be generated. 

The process is recursive and begins by adding the newly created contents label 
(new el) to the primary dependency lists of the contributing contents labels. Then, 
depending on the properties of the compositing operator, none, either or both of the 
contributing contents labels are added to the secondary dependency list. Then every 
contents label representing (clabl op sd2j) and (sdlj op tab2) are added to the secondary 



dependency list. 






Notation 


clabl 


The first contributing contents label. 


clab2 


The second contributing contents label. 


sdli 


The i'th element of clabl's secondary dependency list. 


sd2i 


The i'th element of clab2's secondary dependency list. 



create_binary_contents_label 
( 

clabl : contents label, 
clab2 : contents label, 
op: compositing operator 

) 

BEGIN 

IF the hash table already contains an entry representing clabl op clab2 
THEN 

RETURN the existing contents label representing the combination. 
END IF 

Generate a new entry in the hash table representing clabl op clab2, map- 
ping to new_cl. 

(Add the new contents label to the primary dependency lists of the contribut- 
ing contents labels if the compositing op requires it) 
add_to_primary_dep_list(clab1 , new_cl) 
add_to_primary_depJist(clab2, new_cl) 
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(Generate the secondary dependencies) 
IF op generates left diff rgns THEN 

add clabl to secondary deps 
5 END IF 

IF op generates right diff rgns THEN 

add clab2 to secondary deps 
END IF 

FOR i = 0 TO number of elements in sd1 DO 
10 add_to_secondary_dep_list 

( 

new_cl, 

create_binary_contents_label(sd 1 i, clab2) 

) 

15 END DO 



FOR i = 0 TO number of elements in sd2 DO 
add_to_secondary_dep_list 

( 

20 new_cl, 

create_binary_contents_label(clab1 , sd2j) 

) 

END DO 

END constuct_binary_contents_label 

25 

3.4 Combining Region Groups for Dynamic Rendering 

Before any incremental updates can be made to a compositing tree, the compositing 
tree must be constructed to be in a consistent initial state. The basic technique for 
achieving this is the same as that used for static rendering, except that support for 
30 contents labels is included. 

Leaf node region groups are initialised essentially as with static rendering, except 
that each region in each leaf node region group is tagged with a unique contents label. 
Each contents label can in turn be tagged with various categorisation properties which 
may help the Tenderer to be more efficient. For example, a contents label can be tagged 
35 as being completely opaque. 
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The initialisation of binary nodes is also similar to the static rendering case. By 
way of example, the way in which the region group for an "OVER" binary node is 
constructed will now be explained. The techniques for constructing the region groups of 
the other compositing operators can easily be inferred from the "OVER" case. 

When a difference region between rgj of one operand and the coverage region of the 
other operand is calculated, the difference region inherits the contents label rgj. When an 
intersection region is created, on the other hand, a new contents label is created by 
combining the contents labels of the two contributing regions since the two contributing 
regions had their proxies composited into a new proxy which means new content. The 
pseudocode for constructing an "OVER" region group which includes contents label 
management is provided below: 



Notation 



RGl 


The region group of the binary node's left child 


RG2 
RG 

RGl-^urgn 
RGl-mrgn 


The region group of the binary node's right child 

The region group of the binary node. It is this region group 
that we are initialising 

The region description representing the union of all RGTs 
region descriptions (RGl f s coverage region). 

The region description representing the union of all RG2's 
region descriptions (RG2's coverage region). 


RG-mrgn 


The union of all RG's region descriptions. 


rgli 


The current region in RGl 


rg2j 


The current region in RG2 


rgli->rgn 


rgli's region description 


rg2j->rgn 


rg2j's region description 


rgli— >proxy 


rgli's proxy 


rg2j-»proxy 


rg2j f s proxy 



RG-»urgn = RG1-Hirgn union RG2->urgn 
FOR i = 0 TO number of regions in RG1 DO 
diff_rgn = rg1|->rgn difference RG2->urgn 
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IF diffjgn is non-empty THEN 

ADD to RG a new region with diffjgn as its region description, 
rg1j->proxy as its proxy and rg1|-»clab as its contents label. 
END IF 

5 FOR j = 0 TO number of regions in RG2 DO 

inter_rgn = rg1j-»rgn intersection rg2j->rgn 
IF inter_rgn is non-empty THEN 

new_clab = GENERATE a new unique contents label as a result 
of combining rg1j-»clab and rg2j-»clab. 
10 IF rg1j->clab is OPAQUE THEN 

new_p = rg1i->proxy 
ELSE 

create new proxy new_p initialised to OVER of rg1j->proxy 

and rg2j->proxy inside inter_rgn. 

15 END IF 

ADD to RG a new region with inter_rgn as its region description, 

new p as its proxy and new dab as its contents label. 
END IF 

END DO 

20 END DO 

FOR j = 0 TO number of regions in RG2 DO 

diffjrgn = rg2j-»rgn difference RG1->urgn 

IF diffjgn is non-empty THEN 

ADD to RG a new region with diff_rgn as its region description, 

25 rg2j-*proxy as its proxy and rg2j-»clab as its contents label. 

END IF 

END DO 



3.5 Secondary Dependencies and Over 

30 The rationale behind the method used for generating secondary dependencies 

requires more explanation. Secondary dependencies are only generated when a new 
contents label is created by combining two other contents labels. As can be seen in the 
above pseudocode, this only occurs when an intersection region is generated. Essentially, 
the further embodiment uses contents labels generated for intersection regions as triggers 

35 - the regions tagged with two contents labels cannot indirectly affect one another unless 
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they intersect. The secondary dependency list for a particular contents label is dependent 
on the compositing operator the composite contents label represents, the two contributing 
contents labels and their secondary dependency lists. 

The method of the further embodiment of generating a secondary dependency list 
5 for a new contents label (C) which represents one contents label (A) composited over 
another contents label (B) using the "OVER" operator will now be explained. Elements 
of A's and B's secondary dependency lists are referred to as A { and Bj respectively. First, 
both A and B are added to C's secondary dependency list. This is because if the region 
tagged with C changes its boundary, then it is likely that any regions tagged with A and B 

10 will need to be recalculated (because their regions are likely to abut C's region). Next, 
for each element of B's secondary dependency list, each contents labels representing (A 
OVER Bj) is added. A mapping representing A OVER Bj can not currently exist in the 
system and needs to be created. A secondary dependency list can contain contents labels 
which are not represented by any region in a region group. They could come into 

15 existence by changes in region boundaries. The rationale is that A intersects B, and 
therefore it is likely that A also intersects regions tagged with contents labels which exist 
in B's secondary dependency list. Similarly, for each element of A's secondary 
dependency list, each contents label representing (Aj OVER B) is added. 
3.6 Contents Labels and Damage 

20 The concepts of primary and secondary damage were introduced with reference to 

Fig. 3 to demonstrate that it is not always necessary to regenerate an entire image as a 
result of a change to the compositing tree. By keeping track of dependencies between 
regions of different content, it only becomes necessary to regenerate image data in 
regions whose contents have become damaged. The following explanation outlines the 

25 dependencies and damage for simple compositing tree changes. "Simple" means that 
only leaf nodes are modified. More complex change scenarios such as tree structure 
changes etc will be outlined in later sections. 

If a leaf node is modified, the contents labels of its affected regions are said to be 
"primary damaged". Primary-damaging a contents label involves recursively primary- 

30 damaging all its primary dependencies. Whenever a contents label is primary-damaged, 
all its secondary dependencies are non-recursively marked with secondary damage. The 
process begins by flagging the contents label to be damaged. The following pseudocode 
demonstrates how contents labels can be damaged: 

Notation 
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clab 



pdi 



sdi 



The contents label to be damaged 

The i'th element of clab's primary dependency list. 

The i'th element of clab's secondary dependency list. 



damage_contents_label 



clab : contents label, 

) 

BEGIN 

FLAG clab with PRIMARY damage 

FOR i = 0 TO number of elements in sd DO 
FLAG sdj with SECONDARY damage 
END DO 

FOR i = 0 TO number of elements in pd DO 

damage_contentsJabel(pdj) 
END DO 
END damage_contents_label 

When a tree update occurs, any region with its contents label marked as having 
primary damage will need to recalculate both its region boundaries and its proxy. Any 
region with its contents label marked as having secondary damage will need to recalculate 
its region description but will only need to recalculate its proxy in areas of the new region 
that were not included in the earlier region. 

3.7 Examples of Contents Labels and Dependencies 

In order to clarify the concepts of contents labels and damage, some examples of 
varying complexity will be presented. 
3,7.1 Example 1 

Fig. 9 will result in the following contents label table after the compositing tree is 
initially constructed (Note: in the following table contents labels are represented as 
unique strings not as integers where "over" has been abbreviated to "o". This is simply 
for readability): 
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Contents Label 


Primary Deps. 


Secondary Deps. 


A 


AoB 




B 


AoB 




AoB 




A, B 



If A moves, then AoB will have primary damage, resulting in B having secondary 
5 damage. 

3.7.2 Example 2 

Fig. 10 will result in the following contents label table after the compositing tree is 
initially constructed: 



• • •• 

• • • 

• • 


Contents Label 


Primary Deps. 


Secondary Deps. 


• • 

• • • 


A 


AoB, AoC 




• 

• 

• ••• 


B 


AoB, BoC 




» ••• 


AoB 


AoBoC 


A, B 


• ••• 


C 


AoC, BoC, (AoB)oC 




• • t 


AoC 




A,C 


• • ♦ 


BoC 




B,C 




(AoB)oC 




AoB, C, AoC, BoC 



10 



In this example, every object intersects every other object, so if something changes, 
everything will be damaged in some way - everything which is a primary dependency of 
the changed object will have primary damage, whereas everything else will have 
secondary damage. 

15 Fig. 1 1 illustrates the effect of A moving in a subsequent frame. As can be seen, if 

A is damaged, the regions defined by A, AoB, AoC and (AoB)oC will each have primary 
damage. The regions defined by B, C and BoC will each have secondary damage. 
3.7,3 Example 3 

Fig. 12 will result in the following contents label table after the compositing tree is 
20 initially constructed: 



Contents Label 


Primary Deps. 


Secondary Deps. 


A 


AoB, AoC, AoE, Ao(DoE), 
AoD 




B 


AoB, BoC, BoE 




AoB 


AoBoE 


A, B 
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D 


DoE, AoD, CoD, (AoC)oD 




C 


Dob, AOD, (AOOjOb, DOt, 

CoE, (BoC)oE, (AoC)oE 




Doc 


Ao(Dob), (AoC)o(Dob;, 
Co(DoE) 


D, b 


c 


AoC, BoC, Co(DoE), Cob, 
uod 




A nf 


AnPnP f AnPlnfDriP^ 
/\Ov^O.D, \/\Q\^)0(lJOE), 


A P 


RnP 




B P 


A nF 




A F 






A n R P A nP RnP 


OOCr 




D P 

d, b 


PnP 




P F 


^dOv^joi} 




R/\P P "RnP fViP 






A D 


PnFi 




p n 


(AoC)oE 




AoC, E, AoE, CoE 


Ao(DoE) 




A, DoE, AoD, AoE 


Lo(Uohj 




r* r^p rv*n rv\p 
Dob, uojj, uob 


fAnPVtfi^rkFI 
^/VOL/ JO^UOIl ) 




AoP TViF AnfTViF^ 

Co(DoE), (AoC)oD, 
(AoC)oE 


(AoC)oD 




AoC, D, AoD, CoD 



Since A intersects every other object, if A moves, a large amount of the 
compositing tree will need to be recomputed. Fig. 13 shows that the only part left alone 
is the area corresponding to BoC and its dependent BoCoE. To summarise: 

• Primary Damage - A, AoB, AoC, AoE, Ao(DoE), (AoB)oE, (AoC)oE, 

(AoC)o(DoE), AoD, (AoC)oD 

• Secondary Damage - B, C, E, DoE, BoE, CoE, DoE, CoDoE 

On the other hand, if B moves, the amount of damage is less than if A moved. This 
is because B doesn't intersect D. DoE, Ao(DoE), (AoC)o(DoE), Co(DoE) and (AoC)oE 
(and their ancestors) are not damaged when B moves. This is shown in Fig. 14. The rest 
of the damage is summarised as: 

• Primary Damage - B, AoB, BoC, BoE, (AoB)oE, (BoC)oE 

• Secondary Damage - A, E, C, AoE, CoE 

The examples presented so far are simple, but they are sufficient to demonstrate that 
the dependencies techniques presented so far will damage those contents labels which are 
affected when a particular contents label/s is(are) damaged. In a typical complex 
composite, it is rare for large numbers of objects to intersect a large number of other 
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objects, meaning that large areas of the compositing tree should be untouched during 
updates using the above technique. 

3.8 Example of Secondary Dependencies and Compositing Operators 

Consider a modified version of Example 3 above. Fig. 18, will result in the 
following contents label table after the compositing tree is initially constructed. Note that 
AaB represents A ATOP B and AiB represents A IN B etc: 



Contents Label ! 


Primary Deps 


Secondary Deps j 


A 


AaB 




B 


AaB, BoC 




AaB 




B 


C 


BoC, Co(DiE) 




BoC 




B,C 


D 


DiE 




E 


DiE 




DiE 


Co(DiE) 




Co(DiE) 




C, DiE 



• • • « 

» 

• • • ■ 



10 As seen in Fig. 18, the ATOP operator clips A to B's bounds, meaning that 

intersections between A and any of C, D or E never occur. Similar things occur with the 
IN operator. This means that the objects in this scene are less tightly coupled. For 
example, if A is changed, then only B and AaB are immediately damaged. Similarly, if E 
is damaged, it is only possible for DiE to be damaged. 

15 3.9 Updating Region Groups 

The further embodiment uses the contents label and damage framework to reduce 
the amount of work that has to be done to make a binary region group consistent with its 
updated operands during an update. The further embodiment does this by only updating 
those regions in a region group whose contents labels have primary or secondary damage, 

20 adding any new region which comes into existence as a result of the changes made to the 
compositing tree, and deleting any region in the right group whose contact no longer 
exists. 

Each different binary operator has a different updating function which deals with 
the specific requirement of that operator. The process of updating region groups is a two- 
25 pass process. The first pass updates any intersection regions that have been primary 
damaged and adds any new intersection regions generated due to the damage. Each 
region of one operand's region group is intersected with each region of the other operand's 
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• • 



• ••• 

• • • 

• • • 



• • « 

• ••• 



region group whenever one or both of their corresponding contents labels are primary 
damaged. If the intersection is non-empty, then the further embodiment determines if a 
contents label representing the combination exists. If the contents label doesn't exist, one 
is created and primary damaged. Note that primary damaging a contents label will mark 
5 all it's secondary dependencies with secondary damage. 

If a region in the region group is currently tagged with the primary damage contents 
label, the region boundary and proxy are updated. If no such region exists in this region 
group, then a new region keyed by this contents label is added to the region group. A 
new proxy is generated and assigned to this region along with the right description 

10 relating from the intersection operation. 

A difference between each region group of one operand and the coverage region of 
the other operand is calculated whenever the regions contents label has primary or 
secondary damage. If the difference is non-empty and a region tagged with the contents 
label exists in the region group, then it's region description and proxy reference are 

15 updated. If such a region doesn't exist then a region keyed by the contents label is added 
to the region group. The added region is assigned as a coverage region of the difference 
result and references the proxy of current region. 

Each region of one operand's region group is interacted with each region of the 
other operand's region group whenever the contents label representing their combination 

20 has secondary damage and no primary damage. If the intersection is non-empty, the 
region group is searched looking for a region keyed by the contents label. If such a 
region exists its region description is updated and it's proxy is updated as the difference 
between the new and old regions. If such a region doesn't exist, then a region keyed by 
the contents label is created. The created region description is assigned the result of-the 

25 interaction operation and it's proxy generated. 

Pseudocode which illustrates a simple algorithm for updating a binary "OVER" 
region group is provided below. 



Notation 


RG1 


The region group of the binary node's left child 


RG2 


The region group of the binary node's right child 


RG 


The region group of the binary node. It is this region group 
that is being initialised. 


RGl-*urgn 


The region description representing the union of all RGl's 
region descriptions (RGl's coverage region). 
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RGl-*urgn 


The region description representing the union of all RG2's 
region descriptions (RG2*s coverage region). 


RG->urgn 


The union of all RG's region descriptions. 


rgli 


The current region in RG1 


rg2j 


The current region in RG2 


rgli->rgn 


rgli's region description 


rg2j->rgn 


rg2j's region description 


rgli^proxy 


rgli's proxy 


rg2j->proxy 


rg2j*s proxy 


rgli-»clab 


rgli's contents label 


rg2j^clab 


rg2j's contents label 



• • • 
» • • 

• • • 



• • • • 

» • • 

• • • 



RG-»urgn = RG1->urgn union RG2->urgn 

(First Pass - this pass is used to deal with primary damage of intersection regions 

5 

and any new intersection regions generated) 
FOR i = 0 TO number of regions in RG1 DO 

FOR j = 0 TO number of regions in RG2 DO 

IF rg1i-»clab has PRIMARY damage OR rg2j->clab has PRIMARY 
10 DAMAGE THEN 

inter_rgn = rg1r+rgn intersection rg2p»rgn 
IF interjrgn is non-empty THEN 

comp_clab = SEARCH for an existing contents label which 
represents (rg1j-»clab comp rg2j->clab). 
15 IF a region tagged with comp_clab already exists in RG 

THEN 

IF rg1j-»clab is OPAQUE THEN 

new_p = rg1i-*proxy 
ELSE 

20 create new proxy new_p initialised to OVER of 

rg1|-»proxy and rg2j->proxy inside inter_rgn. 

END IF 

MODIFY the existing region to have inter_rgn as its 
region description and new_p as its proxy. 
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• ••• 

« 



ELSE 

new_clab = create_binary_contents_label(rg1j-»clab, 

rg2j-»clab). 

IF rg1j-»clab is OPAQUE THEN 
5 new_p = rg1j->proxy 

ELSE 

create new proxy new_p initialised to OVER of 
rg1|->proxy and rg2j-*proxy inside inter_rgn. 

END IF 

10 damage_contents_label(new_clab) 

ADD to RG a new region with inter_rgn as its region 
description, new_p as its proxy and new_clab as its contents label. (+) 

END IF 

FLAG the region as being 'RETAIN AFTER UPDATE' 
15 END IF 

END IF 
END DO 
END DO 

20 (Second Pass - this pass is used to deal with primary and secondary damage of 
difference regions and secondary damage of intersection regions) 
FOR i = 0 TO number of regions in RG1 DO 

IF rg1r»clab has PRIMARY or SECONDARY damage THEN 
diff_rgn = rg1|-»rgn difference RG2->urgn 
25 IF diff_rgn is non-empty THEN 

IF a region tagged with rg1j-»clab already exists in RG THEN 
MODIFY it to have diff_rgn as its region description and 
rg1r*proxy as its proxy. 

ELSE 

30 ADD to RG a new region with diff_rgn as its region descrip- 

tion, rg1i-»proxy as its proxy and rg1i-*clab as its contents label. (*) 
END IF 

FLAG the region as being 'RETAIN AFTER UPDATE' 
END IF 
35 END IF 
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FOR j = 0 TO number of regions in RG2 DO 

comp_clab = SEARCH for an existing contents label which represents 
(rg1i->clab comp rg2j-»clab). 

IF comp_clab exists AND comp_clab has SECONDARY damage but 
5 NO PRIMARY damage THEN 

inter_rgn = rg1j-»rgn intersection rg2p»rgn 
IF inter_rgn is non-empty THEN 

GET a reference to the existing region tagged in this region 
group with comp_clab which MUST exist in this region group 
10 IF rg1i->clab is OPAQUE THEN 

existing regions proxy =rglj -»proxy 
ELSE 

update_rgn = inter_rgn difference the region's previous 

region description. 

15 update existing regions proxy to include OVER of 

rgli->proxy and rg2j -» proxy inside update region. 

END IF 

MODIFY the existing region to have inter_rgn as its region 
description and new_p as its proxy. 
20 FLAG the region as being 'RETAIN AFTER UPDATE' 

END IF 
END IF 
END DO 
END DO 

25 

FOR j= 0 TO number of regions in RG2 DO 

IF rg2j-*clab has PRIMARY or SECONDARY damage THEN 
diff_rgn = rg2j->rgn difference RG1-Hirgn 
IF diff_rgn is non-empty THEN 
30 IF a region tagged with rg2j-»clab already exists in RG THEN 

MODIFY it to have diff_rgn as its region description and 
rg2j-»proxy as its proxy. 

ELSE 

ADD to RG a new region with diff_rgn as its region 
35 description, rg2j-»proxy as its proxy and rg2j-»clab as its contents 
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label. (*) 

END IF 

FLAG the region as being 'RETAIN AFTER UPDATE" 
END IF 
END IF 
END DO 

DELETE all regions of RG which are not marked RETAIN AFTER UPDATE but 
whose contents labels have damage, and CLEAR flag in retained regions. 

4.0 Tree Modifications (Linking and Unlinking) 

More complex changes to a compositing tree can be achieved by changing the 
tree's structure. Most typical tree structure changes can be made by using two low level 
operations, link and unlink. 

The unlink operation is used to separate a child node from its parent. After the 
operation is completed, the child node has no parent (meaning the child node can be 
linked in somewhere else), and the parent has a link available (meaning that some other 
node can be linked there instead). Nodes in the compositing tree above the unlinked child 
contain content which is dependent on the unlinked child. Therefore, at the time of the 
next update, the contents label present in the unlinked child at the time of unlinking must 
be damaged to ensure that the dependent region groups higher in the tree are 
appropriately updated. The updating is achieved by the parent node caching away those 
contents labels existing in its unlinked child. If another subtree is linked in its place and 
subsequently unlinked without the region group of the parent being updated, it is not 
necessary to cache the contents labels of this new subtree. Pseudocode for the unlink 
operation is provided below. Note that the UNLINKED_LEFT or UNLINKED_RIGHT 
flag is set so that the contents labels of a newly linked subtree may be damaged when 
region groups (including their proxies) higher in the tree must then be updated, 
unlink 
( 

node : compositing tree node 

) 

BEGIN 

parent = node ->parent. 
node -^parent = NULL. 
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IF node is parent's left child THEN 
parent -*left = NULL. 

IF parent doesn't have UNLINKEDJ.EFT set THEN 
SET the UNLINKED_LEFT flag in parent. 
5 ELSE. 

RETURN. 
END IF 

ELSE IF node is parent's right child THEN 
parent — >right = NULL. 
10 IF parent doesn't have UNLINKED_RIGHT set THEN 

SET the UNLINKED_RIGHT flat in parent. 
ELSE 

RETURN 
END IF 
15 END IF 

COPY all the contents labels in node's region group into an array stored in 
parent ->unlinked_clabs. 
END unlink 

The link operation involves linking a node with no parent to a free link of a parent node. 
20 Pseudocode for the operation is provided below, 
link 
( 

child : compositing tree node, 
parent : compositing tree node, 
25 whichjink : either LEFT or RIGHT 

) 

BEGIN 

child -^parent = parent 
IF whichjink is LEFT THEN 
30 parent ->left = child. 

ELSE 

parent -> right = child. 
END IF 
END LINK 

35 4.1 Updating the Entire Compositing Tree 
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If a leaf node in the compositing tree changes, the region group of every node in a direct 

line from the leaf node to the root of tree must be updated using the methods described 

above. Fig. 15 shows circled those nodes which need to have their region groups updated 
if leaf nodes B and H change in some way. 

5 

Pseudocode for the tree updating method is provided below: 
updatejree 
( 

node : compositing tree node 

10 ) 

BEGIN 

IF node is leaf node THEN 

Rerender the leaf node and update its region group. 
ELSE 

15 IF unlinking occurred in left subtree or left subtree contains dirty leaf 

nodes THEN 

update_tree(node — >left). 
END IF. 

IF unlinking occurred in right subtree or right subtree contains dirty leaf 
20 nodes THEN 

update_tree(node —aright). 
END IF. 

IF node has UNLINKED_LEFT or UNLINKED_RIGHT flags set THEN 
CALL damage_contents_label on every element of 
25 node-»unlinked_clabs. 

IF node has UNLINKED_LEFT set THEN 

CALL damage_contents_label on every contents label exist- 
ing in node-»left's region group. 

CLEAR the UNLINKED_LEFT flag in node. 
30 END IF 

IF node has UNLINKED_RIGHT set THEN 

CALL damage_contents_label on every contents label exist- 
ing in node-*right's region group. 

CLEAR the UNLINKED_RIGHT flag in node. 
35 END IF 
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END IF 

CALL the region group update routine appropriate for node's composit- 
ing operator. 
END IF 
5 END updatejree 

The embodiments of the invention can be implemented using a conventional gen- 
eral-purpose computer system 2100, such as that shown in Fig. 19, wherein the process 
described with reference to Fig. 1 to Fig. 18 are implemented as software recorded on a 
10 computer readable medium that can be loaded into and carried out by the computer. The 
computer system 2100 includes a computer module 2101, input devices 2102, 2103 and a 
display device 2104. 

With reference to Fig 19, the computer module 2101 includes at least one processor 
unit 2105, a memory unit 2106 which typically includes random access memory (RAM) 

15 and read only memory (ROM), input/output (I/O) interfaces including a video interface 
2107, keyboard 2118 and mouse 2120 interface 2108 and an I/O interface 2110. The 
storage device 2109 can include one or more of the following devices: a floppy disk, a 
hard disk drive, a CD-ROM drive or similar a non-volatile storage device known to those 
skilled in the art. The components 2105 to 21 10 of the computer module 2101, typically 

20 communicate via an interconnected bus 2114 and in a manner which results in a usual 
mode of operation of the computer system 2100 known to those in the relevant art. 
Examples of computer systems on which the embodiments can be practised include IBM- 
PC/ ATs and compatibles, Sun Sparcstations or alike computer system. In particular, the 
pseudocode described herein can be programmed into any appropriate language and 

25 stored for example on the HDD and executed in the RAM 2106 under control of the 

processor 2105 with the results being stored in RAM within the video interface 2107 and 

reproduced on the display 2116. The programs may be supplied to the system 2100 on a 

pre-programmed floppy disk or CD-ROM or accessed via a connection with a computer 
network, such as the Internet. 

30 The aforementioned preferred method(s) comprise a particular control flow. There 

are many other variants of the preferred method(s) which use different control flows 
without departing the spirit or scope of the invention. Furthermore one or more of the 
steps of the preferred method(s) may be performed in parallel rather sequential. 

The foregoing describes only several embodimens of the present invention, and 

35 modifications, obvious to those skilled in the art, can be made thereto without departing 
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from the scope of the present invention. 

In the context of this specification, the word "comprising" means "including 
principally but not necessarily solely" or "having" or "including" and not "consisting only 
of 1 . Variations of the word comprising, such as "comprise" and "comprises" have 
corresponding meanings. 
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* region.cpp 

* The implemention of the region manipulation functionality in 

* the Screen OpenPage prototype. 
*/ 



8 include "protos.h" 

static int union_tot = 0; 
static int int_tot = 0; 
static int dif f_tot = 0; 
static int union_full = ec- 
static int int_full » 0; 
static intdiff full = 0; 



* Some Hdefs which are used to control the optimisations used in the region 

* builder implementation.. 
V 

Hdefine R_USE_NEW_IMP 

ft define RB_ FAS T_S H I FT_AND_DU P_ LOO P S 

ffdefine RB_USE_LOOKUP 

8 define R NEW IMP CONSTRUCTION LOOP 



The global variables used to store the temporary results needed during 
region manipulation operations. Two statically allocated 
R_RegionBuilder structures are used. This is to allow data to be 
read from one of them whilst the data required for the next operation 
is written into the other one. Two pointers r_PrevRB and R_CurRB are 
used to swap access to the two static structures. The 
r_grow_region_builder function is called to grow a R_RegionBuilder 
structure if required. 



static R_RegionBuilder r_RBl = {0, 

static R_RegionBuilder r_RB2 = {0, 

static R_RegionBuilder *r_PrevRB = 

R_RegionBuilder *R_CurRB * 



0, NULL, NULL}; 
0 f NULL, NULL}; 
&r_RBl ; 
&r RB2; 



* r_shif t_and_dup 



* A 16-byte lookup table which when provided with an unsigned char 

* of the following form xxyy, simply produces xxxx. This lookup table 



* _assumes_ that R_STATE_SIZE is 2. 

* horribly) if this isn't the case. 
V 

unsigned char r_shif t_and_dup I 16 J = 



It won't work (and will die 



0x00, 
0x05, 
OxOA, 
OxOF, 



0x00, 0x00, 

0x05, 0x05, 

OxOA, OxOA, 

OxOF, OxOF, 



0x00, 
0x05, 
OxOA, 
OxOF 



A buffer is required to store the new region data whilst a region is 
being constructed. This buffer is expanded when required. 



static R_Int 
static int 



*r_RgnBuf = NULL; 
r_RgnBufSize * 0; 



* A buffer of IntXYMinMax structures is required to store the rectangles 

* generated during R_rects_f rom_region . This buffer is expanded when 

* required. 
•/ 

static IntXYMinMax *r RectBuf ■ NULL; 
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static int r_RectBuf Size = 0; 



* R_FREE_LIST_GROWTH_SIZE 

* This macro defines the number of elements which will be added to 

* free list whenever it is grown. 
*/ 

tfdefine RFREELISTGROWTHSIZE 100 
/• 

* r_free_list 
* 

* A linked list of unused R_RgnGrowl terns which may be used during 

* region construction. 
*/ 

R_RgnGrowItem *r_free_list = NULL; 
/* 

* r_growth_list 

* A linked list of R_RgnGrowItems which represents the current 

* state during region construction. 
*/ 

R_RgnGrowItem *r_growth_list = NULL; 
/* 

* r_g row_r eg i on_bu i 1 de r 

* 

* This function simply checks to see if a R_RegionBuilder structure 

* is of the required size. If it isn't the size of both 

* arrays in the R_RegionBuilder structure are doubled. 
* 

* Parameters : 

* rb The region builder to be grown. 

* size The required size of the arrays in the R_RegionBuilder . 

* Returns: 

* TRUE on success, FALSE on failure. 
V 

static int 

r_g row_r eg ion_bu i 1 de r 
( 

R_RegionBuilder *rb, 
R Int size 

) 
( 

unsigned char *new_state_data ; 
R_Int *new_rgn_data ; 

int new_size; 

new_size = max(size, rb->rrb_Size * 2); 

new_state_data = (unsigned char * ) malloc (new_size * sizeof (unsigned char)); 
if (new_state_data == NULL) 

new^rgnuaatfiALS^int *) malloc (new_size * sizeof (R_Int) ) ; 

if (new_rgn_data == NULL) 

{ 

f ree (new_state_data) ; 
return FALSE; 

if (rb->rrb_stateData != NULL) 
{ 

memcpy 
( 

new_state_data , 
rb- >rrb_StateData , 

rb->rrb_Size * sizeof (unsigned char) 

); 

f ree(rb->rrb_StateData) ; 
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/* 



} 

if (rb->rrb RgnData != NULL) 
( 

" memcpy 
( 

new_rgn_data, 

rb- >rrb_RgnData, 
rb->rrb_Size * sizeof (R_Int) 

); 

t ree(rb->rrb_RgnData) ; 

} 

rb->rrb_StateData = new_state_data ; 
rb->rrb_RgnData = new_rgn_data ; 
rb->rrb_Size = new_size; 
return TRUE; 



* r_swap_region_builders 
* 

* This function simply swaps the static pointers to the r_RBl and r_RB2 

* region builders. 
* 

* Parameters: 

* None . 

* Returns: 

* Nothing. 
*/ 

inline static void 
r_swap_region_builders ( ) 

{ 

R_RegionBuilder *tmp; 
tmp = R_CurRB; 
R_CurRB = r_PrevRB; 
r_PrevRB = tmp; 

} 

* R_add_row_to_region_builder 

* This function adds a row from a R_Region to a R_RegionBuilder structure. 

* The region from which the row comes is passed as an argument. "Adding" 

ft has the oMow^^e^rfc^ijp^sc^ row does not exist in the region builder 

* it is added and it's current state is tagged with the region 

* to which the row belongs. The previous state is set to 0, 

* indicating that it did not exist before. 

* * If a pixel run in the row did exist before, but it's present state 

* indicates that it came from the other region then the run 

* is retained but it's state is modified to indicate that 

* both regions are active at this point. 

* * If a pixel run in the row did exist before, and it's present 

* state indicates that the current region then the region is 

* removed and it's state is modified to indicate that the run is 

* now empty. 

* * If a pixel run in the row did exist before, and it's present state 

* indicates that both regions are currently active then the run 

* is retained, but its state is modified to indicate that only the 

* other region is active in this run. 

* 

* Parameters: 

* row_ptr A R_Int pointer to the row in the region. Used 

* to return the updates row pointer. 

* rgn_mask A mask for the region the row comes from. Must 

* be either 1 or 2 . 

* first Whether this is the first region to be processed 

* on the current scanline. 

* Returns: 
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* TRUE on success, FALSE on failure. 

*/ 
«if 1 
int 

R_add_row to_region_builder 
( 

R_Int **row_ptr, 
int rgn_mask, 
int first 



R_Int *row; 

int src_index; 

int dest_index; 

R_Int rb_run_start ; 

unsigned char rb_prev_run_state; 

int row_on; 

ASSERT (rgn_mask == 1 | | rgn_mask == 2) ; 

row = *row_ptr; 
r_swap_region_builders ( ) ; 
/* 

* Skip over the row's y value at the beginning. 
V 

ASSERT(*row == R_NEXT_IS_Y) ; 
row + = 2; 

ASSERT (* row != R_NEXT_IS_Y && *row != R_EOR) ; 

if (r_PrevRB->rrb_Nels == 0) 
{ 

/* 

* If the current region builder's src region data array is empty, then 

* we are dealing with an empty region builder. We simply convert 

* the input row to the region builder format. 
*/ 

row_on = TRUE ; 

wBSl£i^eKO?_fiMD_OF_ROW(*row) ) 
{ 

if (++dest_index > R_CurRB->rrb_Size) 

{ 

if ( !r_grow_region_builder (R_CurRB, dest_index) ) 
return FALSE; 

) 

R_CurRB->rrb_RgnData (dest_index - 1] = *row; 
if (row_on) 

R_CurRB->rrb_StateData [dest_index - 1] = 

(rgn_mask « RB_STATE_SIZE) ; 

else 

R_CurRB->rrb_StateData [dest_index - 1] = 0; 
row_on = !row_on; 
row++ ; 

> 

♦rowjptr = row; 

R_CurRB->rrb_Nels = dest_index; 
return TRUE; 

} 

/* 

* Firstly, we copy any runs from the region builder which 

* precede this run from the region. We are checking the 

* starting row against the start of each pixel run. Therefore 

* we start checking against the lnd region builder data 

* element. 
*/ 

ASSERT ( r_Pr evRB- > r rb_Ne 1 s >= 2) ; 
src_index = 0; 

while (src index < r PrevRB->rrb Nels && *row > r PrevRB->rrb RgnData (src_index) ) 
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src_index++; 
dest_index = src_index; 
if (src index > 0) 
{ 

if (src__index > R CurRB->rrb Size) 
{ 

if ( !r_grow_region_builder (R_CurRB, src_index) ) 
return FALSE; 

} 

memcpy 
( 

R_Cu r RB - > r r b_Rg nDa c a , 
r_PrevRB- >rrb_RgnDa ta ( 
src index * sizeof (RJnt ) 

); 

if Ufirst) 



{ 



memcpy 
{ 



>; 



R_CurRB- >rrb_StateData , 
r_PrevRB- >rrb_StateData , 
src_index * sizeof (unsigned char) 



} 

else 
{ 

int i = 0; 

unsigned char ♦src; 
unsigned char ♦dest; 

src = r_PrevRB->rrb_StateData + src_index; 
dest = R_CurRB->rrb_StateData + src_index ; 
switch (src_index) 
{ 

default : 

for (i e src index; i > 10; i--) 
{ 

tfifndef RB_USE_LOOKUP 

*(dest - i) = (*(src - i) & RB_CUR_STATE_MASK) 
(♦(src - i) >> RB STATE_S I ZE ) ; 

#else 

♦(dest - i) = r_shif t_and_dup[* (src - i)J; 

flendif 

} 

/* FALLTH ROUGH! ! ♦/ 
case 10 : 
tfifndef RB_USE_LOOKUP 

♦(dest - 10) = (Msrc - 10) & RB_CUR_STATEJ4ASK) | 
(Msrc - 10) » RB STATE SIZE) ; 

ttelse 

*(dest - 10) = r_shift_and_dup[* (src - 10)]; 

tfendif 

case St* FALLTH ROUGH ! ! */ 
ttifndef RB_USE_LOOKUP 

*(dest - 9) = (Msrc - 9) & RB_CUR_STATEJ4ASK) | 
(*(src - 9) >> RB_STATE_SIZE) ; 

#else 

* (dest - 9) = r_shift_and dup(*(src - 9)1; 

ftendif 

/♦ FALLTH ROUGH ! ! ♦/ 
case 8: 
Hifndef RB_USE_LOOKUP 

♦(dest - 8) = (Msrc - 8) & RB_CUR_S TATE_MAS K ) | 
(*(src - 8) >> RB_STATE_SIZE) ; 

ttelse 

♦(dest - 8) a r shift and_dup [♦ (src - 8)]; 

tfendif 
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/* FALLTHROUGH! ! */ 
case 7: 
ftifndef RBJJSE_LOOKUP 

Mdest - 7) = (*(src - 7) & RB_C U R_S TATE_MAS K ) | 
(Msrc - 7) >> RB_STATE_SIZE) ; 

ftelse 

Mdest - 7) = r_shift_and_dup{Msrc - 7)1; 

ftendif 

/* FALLTHROUGH! ! */ 
case 6: 
ffifndef R_USE_ LOOKUP 

Mdest - 6) = (Msrc - 6) & RB_CUR_STATE_MASK) | 
(Msrc - 6) >> RB_STATE_SIZE) ; 

Helse 

Mdest - 6) = r_shif t_and_dup(* (src - 6) ] ; 

Hendif 

/* FALLTHROUGH! ! */ 
case 5: 
Hifndef RB_USE_LOOKUP 

Mdest - 5) = (*(src - 5) & RB_CUR_S TATEJ4AS K ) | 
(*(src - 5) >> RB_STATE_SIZE) ; 

#else 

Mdest - 5) = r_shi£t_and_dup(Msrc - 5) ) ; 

#endif 

/* FALLTHROUGH! ! */ 
case 4 : 
8ifndef RB_USE_LOOKUP 

Mdest - 4) = (*(src - 4) & RB_CUR_S TATE_MAS K ) | 
(Msrc - 4) >> RB_STATE_SIZE) ; 

Kelse 

*(dest - 4) = r_shif t_and_dup[Msrc - 4)); 

tfendif 

/* FALLTHROUGH! ! */ 
case 3 : 
tfifndef RB_USE_LOOKUP 

Mdest - 3) = (Msrc - 3) & RB_CUR_STATE_MASK) | 
(Msrc - 3) >> RB_STATE_SIZE) ; 

#else 

Mdest - 3) = r_shift_and_dup[Msrc - 3)]; 

#endif 

/* FALLTHROUGH! ! */ 
case 2: 
tfifndef RB_USE_LOOKUP 

*(dest - 2) o (*(src - 2) & RB_CUR_STATEJ4ASK) | 
(Msrc - 2) >> RB — STATE SIZE) ; 

tfelse 

Mdest - 2) = r_shif t_and_dup(Msrc - 2)]; 

tfendif 

/* FALLTHROUGH! ! */ 
case 1: 
Hifndef RBJJSE_LOOKUP 

Mdest - 1) = (*(src - 1) & RB_CUR_STATE_MAS K ) | 
(*(src - 1) >> RB STATE SIZE) ; 



ttelse 
Hendif 



Mdest - 1) = r_shift_and_dup(Msrc - 1) ] ; 

/* FALLTHROUGH! ! */ 
case 0: 



/* FALLTHROUGH! ! */ 

} 

) ) 

if (src_index « r_PrevRB->rrb_Nels) 

{ 

/* 

* We've already exhausted the previous region builder. Set the start 

* of the next pixel run to be the max. possible and set the state 
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* to be 0. 
*/ 

rb_run_start = R_INT_MAX_VALUE - 2; 
rb prev run state = 0; 

} - - - 

else 
{ 

/* 

* We are still within the previous region builder bounds. Set up 

* the run info appropriately. 
*/ 

rbrunstart = r_PrevRB->rrb_RgnData (src_index) ; 
if (src_index == 0) 

rb_prev_run_state = 0; 

else 

rb_prev_run_state = r_PrevRB- >rrb_StateData [src_index - 1] ; 



/* 

* We can now start dealing with the elements in the row. 
*/ 

row_on = l; 

while (R_N0T END OF R0W(*row)) 

{ " " 

{f (*row < rb_run_start) 

if (dest index + 1 > R CurRB->rrb Size) 

{ 

if ( !r_grow_region_builder (R_CurRB, dest_index + 1)) 
return FALSE; 

) 

R_CurRB->rrb_RgnData [dest_index] » *row; 

if (first) 

{ 

/* 

* We are processing the first region. Therefore, we 

* copy the current state of the run to the lowest 

* RB_STATE_SIZE bits. 
*/ 

R_CurRB->rrb_StateData (dest_index) = 

(rb_prev_run_state & RB_CUR_STATE_MAS K ) | 
(rb prev run state >> RB STATE SIZE) ; 

) " " 

else 
( 

/* 

* We are processing the second region. Therefore, the state data 

* has already been copied to the previous state area so we 

* just copy the state. 
V 

R_CurRB->rrb_StateData (dest_index) = rb_prev_run_state ; 

/* 

* Now, if the row for the current region is active at this transition, 

* we xor the region mask with the current contents of the new region 

* builder slot. This gives the desired behaviour of making that region 

* active if it is not there already, but turns it off if it is... 
*/ 

i f ( row_on ) 

R_CurRB->rrb_StateData [dest_index] A = (rgn_mask << RB_STATE_SIZE) ; 
dest_index++; 
/* 

* We now move onto the next row element . 
*/ 

row++ ; 

row_on = ! row_on ; 
continue; 

) 
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/• 

* If the current row transition point is equal in x position to the current 

* previous region builder transition point, we advance the row counter to 

* the next position. 
*/ 

if (*row = = rb_run start) 

{ 

row+ + ; 

row_on = ! row_on ; 

} 

/* 

* Output the previous regions builder's transition region. We do similiar 

* things as for the region transition stuff above.. Firstly though, we 

* advance the rb_prev_run_state variable to the next element. We know 

* we can do this because if we were on the last element, we wouldn't 

* have hit this section of code. 
*/ 

rb_prev_run_state = r_PrevRB- >rrb_StateData (src_index) ; 
if (dest_index + 1 > R_CurRB->rrb_Size) 

{ 

if ( ! r_grow_region_builder (RCurRB, dest_index + 1)) 
return FALSE ; 

) 

R_CurRB->rrb_RgnData (dest_index) = rb_run_start ; 

if (first) 

( 

R_CurRB->rrb_StateData [dest_index] = {rb_prev_run_state & 

RB_CUR_STATE_MASK) | 
rbjprev_run_state >> RB_STATE_SIZE) ; 

) 

else 

( 

R_CurRB->rrb_StateData (dest_index) = rb_prev_run_state ; 

} 

if ( ! row_on ) 

R_CurRB->rrb_StateData[dest_index) * = (rgn_mask << RB_STATE_SIZE) ; 
dest index++; 
/* 

* We've output the previous region builder 1 s transitions. We now move 

* over onto the next transition. If the previous src_index increment 

* has moved us onto the last element, we declare that we have run 

* out of previous region builder data. 
V 

ASSERT (rb_run_s tart ! = R_EOR) ; 

if (++src_index >= r_PrevRB->rrb_Nels) 

{ 

/* 

* We've run out of data. . 
*/ 

rb_run_start = R_INT_MAX_VALUE - 2; 
continue,- 

) 

* Otherwise, we still have stuff left to do, so we move onto 

* the next run in the previous region builder. 
*/ 

rb_run_start = r_PrevRB->rrb_RgnData (src_index] ; 



Now, we simply blast out any remaining region builder transition 
points . 

/ 

(r_PrevRB->rrb_Nels - src_index > 0) 
R_Int nels_to_copy ; 

nels_to_copy * r_PrevRB->rrb_Nels - src_index; 

if (dest_index ♦ nels_to_copy > R_CurRB- >rrb_Size) 

{ 
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if ( !r_grow_region_builder (R_CurRB, dest_index ♦ nels_to_copy) ) 
return FALSE ; 

) 

memcpy 
< 

R_CurRB->rrb_RgnData + dest_index, 
r_PrevRB->rrb_RgnData + src_index, 
nels_to_copy * sizeof (R_Int ) 

); 

if (!first) 
{ 

memcpy 
( 

R_CurRB->rrb_StateData + dest_index, 
r_PrevRB->rrb_StateData + src_index, 
nels_to_copy * sizeof (unsigned char) 

); 

dest_index += nels to_copy; 

} 

else 

{ 

int i = 0; 

unsigned char *src; 

unsigned char *dest; 

i = r_PrevRB->rrb_Nels - src_index; 

src = r_PrevRB->rrb_StateData + r_PrevRB- >rrb_Nels ; 

dest_index += i; 

dest a R_CurRB->rrb_StateData + destindex; 

switch (i) 

{ 

default: 

for (; i > 10; i--) 
( 

fjifndef RB_USE_L00KUP 

Mdest - i) = (*{src - i) & RB_CUR_STATE_MASK) | 
(Msrc - i) >> RB_STATE — SIZE) ; 

tfelse 

Mdest - i) = r_shif t_and_dup[* (src - i)]; 

flendif 

} 

case llOi FALLTHROUGH! ! */ 
ftifndef RB_USE_LOOKUP 

*(dest - 10) = (Msrc - 10) & RB_CUR_STATE_MAS K ) | 
(*(src - 10) » RB_STATE SIZE) ; 

ftelse 

Mdest - 10) = r_shif t_and_dup[* (src - 10)]; 

tfendif 

/* FALLTHROUGH I ! */ 
case 9: 
ftifndef RB_USE_LOOKUP 

*(dest - 9) = (Msrc - 9) & RB_CUR_STATE_MASK) | 
(Msrc - 9) >> RB_STATE_SIZE) ; 

Helse 

Mdest - 9) = r_shif t_and_dup(Msrc - 9)]; 

ftendif 

/* FALLTHROUGH! ! */ 
case 8 : 
ttifndef RB_USE_LOOKUP 

Mdest - 8) = (Msrc - 8) & RB_CUR_STATE_MASK) | 
(♦(src - 8) >> RB_STATE_SIZE) ; 

tfelse 

Mdest - 8) = r_shif t_and_dup(* (src - 8)); 

ftendif 

/* FALLTHROUGH ! I */ 
case 7: 
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Hifndef RB_USE_LOOKUP 

Mdest - 7) = (Msrc - 7) & RB_CUR_STATE_MASK) I 
^ (Msrc - 7) >> RB_STATE_SIZE) ; 

^ Helse 

Mdest - 7) = r_shif t_and_dup(Msrc - 7) ) ; 

Hendif 

/* FALLTH ROUGH ! ! */ 
case 6: 
fjifndef RB JJSE_LOOKUP 

Mdest • 6) = (Msrc - 6) & RB_CUR_S TATE_MAS K ) | 
(Msrc - 6) >> RB_STATE_SIZE) ; 

flelse 

Mdest - 6) = r_shif t_and_dup(* (src - 6)); 

flendif 

/* FALLTHROUGH! ! */ 
case 5: 
Hifndef RBJJSE_LOOKUP 

Mdest - 5) = (Msrc - 5) & RB_CUR_STATE_MAS K ) | 
(Msrc - 5) >> RB STATE_SIZE) ; 

Helse 

*(dest - 5) = r_shif t_and_dup[* (src - 5)); 

ttendif 

/* FALLTHROUGH! ! */ 
, ## :\ case 4: 

* tfifndef RB_USE_LOOKUP 

*(dest - 4) = (*(src - 4) & rb_cur_STATE_mas k ) | 

./ (*(src - 4) >> RB_STATE_SIZE) ; 

! # : tfelse 

*(dest - 4) = r_shift_and_dup(Msrc - 4)]; 

ttendif 

/* FALLTHROUGH! ! */ 

• •• 

case 3 : 
flifndef RBJJSE_LOOKUP 

• •••^ *(dest - 3) = (* (src - 3) & RB_CUR_STATE_MA£ K ) | 

• (*{src - 3) >> RB_STATE_SIZE) ; 
flelse 

" # * Hendif *(dest - 3) = r_shif t_and_dup [Msrc - 3)]; 

• ••• /* FALLTHROUGH ! ! */ 
•• w ! case 2: 

ftifndef RB_USE_LOOKUP 
•••• ^" Mdest - 2) = (Msrc - 2) & RB_CUR_STATE_MAS K ) | 

(Msrc - 2) >> RB_STATE_SIZE) ; 

tfelse 

Mdest - 2) = r shif t_and_dup(Msrc - 2)J; 

Hendif 

/* FALLTHROUGH \ ! */ 
case 1: 
tfifndef RB_USE_LOOKUP 

Mdest - 1) = (*(src - 1) &. RB_CUR_S TATE_MAS K ) | 
(*(src - 1) >> RB_STATE_SIZE) ; 



• • • 
• 



tfelse 
Hendif 



Mdest - 1) = r_shif t_and_dup(* (src - 1)]; 

/* FALLTHROUGH! ! */ 
case 0: 



/* FALLTHROUGH! ! */ 

} 

) 

) 

/* 

* Finally, we set the number of elements of the latest region 

* builder, we also return the updates row variable. 
•/ 

R_CurRB->rrb_Nels = dest_index; 
*row_ptr = row; 
return TRUE; 
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) 

Uelse 
int 

R_add_row_to_region_builder 
( 

R_Int **row_ptr, 
int rgn_mask, 
int first 



R_Int *row; 

R_Int rb_run_start ; 

unsigned char rb_prev_run_state ; 

int row_on; 

int dest_index; 

unsigned char *src_state_ptr ; 

unsigned char *dest_state_ptr ; 

unsigned char *src_state_end_ptr ; 
register R_Int *src_rgn_ptr ; 

R_Int *src_rgn_end_ptr ; 
register R_Int *dest_rgn_ptr ,- 

R_Int *dest_rgn_end_ptr ; 

int inc ; 

int i ; 

ASSERT (rgn_mask == 1 | | rgn_mask == 2) ; 

row = *row_ptr; 
r_swap_region_builders ( ) ; 
/* 

* Skip over the row's y value at the beginning. 
*/ 

ASSERT (*row == R_NEXT_IS_Y) ; 
row += 2; 

ASSERT (* row != R_NEXT_IS_Y && *rOW != R_EOR) ; 

if (r_PrevRB->rrb_Nels == 0) 
{ 

/* 

* If the current region builder's src region data array is empty, then 

* we are dealing with an empty region builder. We simply convert 

* the input row to the region builder format. 
r6w_on = TRUE; 

dest_index = 0; 

while ( R_NOT_ END OF_ROW ( *row) ) 
( 

if (++dest_index > R Cur RB - > r rb_S i ze ) 

{ 

if { ! r_grow__region_builder (R_CurRB , dest_index) ) 
return FALSE; 

> 

R_CurRB->rrb_RgnData [dest_index - 1] = *row ; 
i f ( row_on ) 

R_CurRB->rrb_StateData (dest_index - 1) = 

(rgn_mask << RB_STATE_S I ZE ) ; 

else 

R_CurRB->rrb_StateData (dest_index - 1) = 0; 
row_on = ! row_on ; 
row + + ; 

} 

*row_ptr = row; 

R_CurRB->rrb_Nels = dest_index; 
return TRUE; 

) 

/• 

* Firstly, we copy any runs from the region builder which 
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* precede this run from the region. We are checking the 

* starting row against the start of each pixel run. Therefore 

* we start checking against the lnd region builder data 

* element. 
*/ 

src_state_ptr = r_PrevRB- >rrb_StateData; 
src_rgn_ptr = r_PrevRB->rrb_RgnData,- 

src_state_end_ptr = src_state_ptr + r_PrevRB->rrb_Nels ; 
src_rgn_end_ptr o src_rgn_ptr ♦ r_PrevRB->rrb_Nels ; 
dest_state_ptr = R_CurRB- >rrb_StateData ; 
dest_rgn_ptr = R_CurRB->rrb_RgnData ; 
dest_rgn_end_ptr = dest_rgn_ptr + R_CurRB->rrb_Size ; 

ASSERT(r_PrevRB->rrb_Nels >= 2); 

while (src_rgn_ptr != src_rgn_end_ptr && *row > *src_rgn_ptr) 

src_rgn_ptr++; 
inc = src_rgn_ptr - r_PrevRB- >rrb_RgnData; 

if (inc > 0) 

{ 

src_state_ptr += inc; 
dest_state_ptr += inc; 
dest_rgn_ptr += inc; 
if (dest_rgnjptr > dest_rgn_end_ptr) 

if ( ! r_grow_region_builder (R_CurRB, inc) ) 

return FALSE; 
dest_state_ptr = R_CurRB->rrb_StateData ; 
dest_rgn_ptr = R_CurRB->rrb_RgnData; 
dest_rgn_end_ptr = dest_rgn_ptr + R_CurRB- >rrb_Size ; 

) 

1 

const R_Int * const src_rgn_ptr2 = src_rgn_ptr; 

R_Int *dest_rgn_ptr2 = dest_rgn_ptr ; 

switch(inc) 

( 

default : 

for {i = inc.- i > 10; i--) 
{ 

* (dest_rgn_ptr2 - i) = * (src_rgn_ptr - i) ; 

) 

/* FALLTHROUGH! ! */ 
case 10: 

* (dest_rgn_ptr2 - 10) = * (src_rgn_ptr2 - 10); 

/* FALLTHROUGH! I */ 
case 9: 

* (dest_rgn_ptr2 - 9) 

/* FALLTHROUGH! ! */ 
case 6: 

* (dest_rgn_ptr2 - 8) 

/* FALLTHROUGH! ! */ 
case 7; 

* (dest_rgn_ptr2 - 7) 

/* FALLTHROUGH! ! */ 
case 6: 

* (dest_rgn — ptr2 - 6) 

/* FALLTHROUGH! ! */ 
case 5: 

* (dest_rgn_ptr2 - 5) 

/* FALLTHROUGH! ! */ 
case 4: 

* (dest_rgn_ptr2 - 4 ) 

/* FALLTHROUGH! ! */ 
case 3: 

* (dest_rgn_ptr2 - 3) 

/* FALLTHROUGH! ! •/ 
case 2: 

* (dest_rgn_ptr2 - 2) 



= * (src_rgn_ptr2 - 9); 
e * (src_rgn_ptr2 - 8) ; 
= * (src_rgn_ptr2 - 7) ; 
= * (src_rgn_ptr2 - 6) ; 
= * (src_rgn_ptr2 - 5) ; 
= * (src_rgn_ptr2 - 4); 
= * (src_rgn_ptr2 - 3); 
= Msrc_rgn_ptr2 - 2); 
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tfelse 



/* FALLTHROUGH! ! */ 
case 1: 

* <dest_rgn_ptr2 - l) = Mere rgn_ptr2 - 1) ; 
/* FALLTHROUGH! ! */ 
case 0: 

/* FALLTHROUGH! ! */ 



memcpy 
( 

R_Cu r RB - > r rbRgnDa t a , 
r_PrevRB- >rrb_RgnData , 
inc * sizeof (RJnt) 

) ; 



flendif 



if {'first) 
( 

memcpy 
< 

R_Cu r RB - > r r b_S t a t eDa t a , 
r_PrevRB- >rrb_StateData , 
inc * sizeof (unsigned char) 

) ; 

} 

else 

{ 

switch (inc) 
( 

default: 

for (i = inc; i > 10; i--) 
( 

tfifndef RB_USE_LOOKUP 

* (dest_state_ptr - i) = (* (src_state_ptr - i) & 

RB_CUR_S T ATE_MAS K ) | 
(* (src_state_ptr - i) » 
RB_STATE_SIZE) ; 

Seise 

* (dest_state_ptr - i) = r_shif t_and_dup (* (src_state_ptr - i) ) ; 

tfendif 

} 

/* FALLTHROUGH! ! */ 
case 10: 
tfifndef RB_USE_LOOKUP 

* (dest_state_ptr - 10) = (* (src_state_ptr - 10) & 

RB_CUR_STATE_MASK) | 
(* (src_state_ptr - 10) >> 
RB_STATE_SIZE) ; 

ttelse 

* (dest_state_ptr - 10) = r_shif t_and_dup [* (src_statejptr - 10)); 

tfendif 

/* FALLTHROUGH! ! */ 
case 9: 
tfifndef RB_USE_LOOKUP 

* (dest_state_ptr - 9) = (Msrc_state_ptr - 9) & RB_CUR_STAT E_MAS K ) | 

(* (src_state_ptr - 9) >> RB_STATE_SIZE) ; 

Seise 

* (dest_state_ptr - 9) = r_shif t_and_dup (* (src_state_ptr - 9)1; 

ttendif 

/* FALLTHROUGH! ! */ 
case 8: 
flifndef RB_USE_LOOKUP 

* (dest_state_ptr - 8) = (* (src_state_ptr - 8) & RB_CUR_STATE J4AS K ) | 

<Msrc_state_ptr - 8) >> RB STATERS I ZE ) ; 

ttelse 

* (dest_state_ptr - 8) = r_shif t_and_dup [* (src_state_ptr - 8)); 

Hendif 

/* FALLTHROUGH! ! */ 
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case 7: 
8ifndef RB_USE_LOOKUP 

* (dest_state_ptr - 7) = ( * (src_state_ptr - 7) & RB_CUR_STATE_MASK) | 

(* (src_state_ptr - 7) >> RB_STATE_SIZE) ; 

Seise 

* (dest_state_ptr - 7) = r_shif t_and_dup [ * (src_state_ptr - 7)); 

» end if 

/* FALLTHROUGH! ! */ 
case 6 : 
tfifndef R_USE_LOOKUP 

* (dest_state_ptr - 6) = { * (src_state_ptr - 6) & RB_CUR_STATE_MAS K ) | 

(* (src_state_ptr - 6) >> RB_STATE_SIZE) ; 

tfelse 

* (dest_state_ptr - 6) = r_shif t_and_dup ( * (src_state_ptr - 6)1; 

ttendif 

/* FALLTHROUGH! ! */ 
case 5: 
Hifndef RB_USE_LOOKUP 

* (dest_state_ptr - 5) = { * (src_state_ptr - 5) & RB_CUR_STAT E__MAS K ) | 

(* (src_state_ptr - 5) >> RB_STATE_SIZE) ; 

ttelse 

* (dest_statej?tr - 5) = r_shift_and dup [* (src_state_ptr - 5)J; 

ttendif 

/* FALLTHROUGH! ! */ 
case 4 : 
Hifndef RB_USE_LOOKUP 

Mdest_state_ptr - 4) = (* (src_state_ptr - 4) & RB_CUR_STATE_MASK) | 

(* (src_state_ptr - 4) >> RB_STATE_SIZE) ; 

ttelse • 

* (dest_state_ptr - 4) = r_shif t_and_dup I* (src_state_ptr - 4)); 

tfendif 

/* FALLTHROUGH! ! */ 
case 3 : 
#ifndef RB_USE_LOOKUP 

Mdest_state_ptr - 3) = (* (src_state_ptr - 3) & RB_CUR_STATE_MASK) | 

{* (src_state_ptr - 3) >> RB_STATE_SIZE) ; 
#else * (dest_state_ptr - 3) = r_shif t_and_dup [* {src_state_ptr - 3)); 

ttendif 

/* FALLTHROUGH! ! */ 
case 2 : 
ftifndef RB_USE_LOOKUP 

* (dest_statejptr - 2) = (* (src_statejptr - 2) & RB_CUR_STATE_MASK) | 

(Msrc_statejptr - 2) >> rI_STATE_SIZE) ; 

ttelse 

* {dest_state_ptr - 2) = r_shift_and dup [* (src_state_ptr - 2)3; 

ttendif 

/* FALLTHROUGH! ! */ 
case 1: 
tfifndef RB_USE_LOOKUP 

* (dest_state_ptr - 1) = (* (src_state_ptr - 1) & RB_CUR_STATE_MASK) | 

(* (src_state_ptr - 1) >> RB_STATE_SIZE) ; 



tfelse 
ttendif 



* (dest_state_ptr - 1) = r_shif t_and_dup (* (src_state_ptr - l)J; 

/* FALLTHROUGH! ! */ 
case 0: 



/* FALLTHROUGH! ! */ 

} 

} 

} 

if (src_state_ptr src state_end_ptr) 
{ 

/* 

* We've already exhausted the previous region builder. Set the start 

* of the next pixel run to be the max. possible and set the state 

* to be 0. 
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rb_run_start = R_ I NT_MAX_V A LU E - 2; 
rb_prev_run_state = 0; 

else 
{ 

/* 

* We are still within the previous region builder bounds. Set up 

* the run info appropriately. 
V 

rb_run_start = *src_rgn_ptr ; 

if (src_state_ptr == r_PrevRB- >rrb_StateData) 

rb_prev_run_state =0; 
else rb_prev_run_state = * (src_state_ptr - 1) ; 



* We can now start dealing with the elements in the row. 
*/ 

row_on = 1; 

while (R_NOT_END_OF_R0W ( * row) ) 
{ 

if (*row < rb run start) 



{ 



if (dest_ rgn_ptr + 1 > dest_rgn_end_ptr) 

{ 

if ( !r_grow_region_builder (R_CurRB, dest_rgn_ptr - R_CurRB- 

>rrb_RgnData + 1)) return FALSE; 
dest_state_ptr = R_CurRB->rrb_StateData ; 
dest_rgn_ptr = R_CurRB->rrb_RgnData; 
dest_rgn_end_ptr = dest_rgn_ptr + R_CurRB->rrb_Size; 

} 

*dest_rgn_ptr = *row; 

if (first) 

{ 

/* 

* We are processing the first region. Therefore, we 

* copy the current state of the run to the lowest 

* RB_STATE_S I ZE bits. 
*/ 

*dest_state_ptr = (rb_prev_run_state & RB_CUR_STATE_MASK) | 
(rb_prev_run_state >> RB_STATE_SIZE) ; 



) 

else 
{ 



/* 

* We are processing the second region. Therefore, the state .data 

* has already been copied to the previous state area so we 

* just copy the state. 
*/ 

*dest_statejptr = rb_prev_run_state; 



* Now, if the row for the current region is active at this transition, 

* we xor the region mask with the current contents of the new region 

* builder slot. This gives the desired behaviour of making that region 

* active if it is not there already, but turns it off if it is... 
V 

if (row_on) 

*dest_state_j>tr A = (rgnjnask << RB_STATE_S I ZE ) ; 
dest_8tate_ptr++ ; 
dest rgn_ptr++; 
/* 

* We now move onto the next row element . 
V 

row++ ; 

row_on = l row on ; 
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continue; 

} 

/* 

* If the current row transition point is equal in x position to the current 

* previous region builder transition point, we advance the row counter to 

* the next position. 
*/ 

if (*row == rb_run_start) 

{ 

r ow+ + ; 

row_on « • row_on ; 

} 

/* 

* Output the previous regions builder's transition region. We do similiar 

* things as for the region transition stuff above. . Firstly though, we 

* advance the rb_prev_run_state variable to the next element. We know 

* we can do this because if we were on the last element, we wouldn't 

* have hit this section of code. 
•/ 

rb_prev_run_state = *src_state_ptr; 

if (dest_rgn_ptr ♦ 1 > dest_rgn_end_ptr) 

{ 

if ( ! r_grow_region_builder (R_CurRB , dest_rgn_j>tr - R_CurRB- >rrb_RgnData 

+ 1) ) return FALSE; 
dest_statejptr = R_CurRB->rrb_StateData ; 
dest_rgn_ptr = R_CurRB->rrb_RgnData; 
dest_rgn_end_ptr = dest_rgn_ptr + R_CurRB->rrb_Size; 

} 

*dest_rgn_ptr = rb_run_start ; 

if (first) 

{ 

*dest_state_ptr = (rb_prev_run_state & RB_CUR_STATE_MASK) | 
(rb_prev_run_state » RB_STATE_SIZE) ; 

} 

else 

{ 

*dest_state_ptr = rb_prev_run_state ; 
if ( ! row_on) 

*dest_state_ptr "= (rgn_mask << RB_STATE_SIZE) ; 
dest_state_ptr++ ; 
jdest_rgn_ptr++ ; 

* We've output the previous region builder's transitions. We now move 

* over onto the next transition. If the previous src_index increment 

* has moved us onto the last element, we declare that we have run 

* out of previous region builder data. 
*/ 

ASSERT (rb_run_start != R_EOR) ; 
++src_rgnjptr; 

if (♦+src_state_ptr == src_state end_ptr) 

{ 

/* 

* We've run out of data.. 
*/ 

rb_run_start = R_ I NT_MAX_V ALU E - 2; 
continue; 

} 

* Otherwise, we still have stuff left to do, so we move onto 

* the next run in the previous region builder. 
*/ 

rb_run_start = *src_rgn_ptr ; 



Now, we simply blast out any remaining region builder transition 
points . 
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if (src_state_j)tr != src_state_end_ptr) 
R_Int nels_to_copy; 

nels_to_copy = src_state_end_ptr - src_state_ptr ; 
if (dest_rgn_ptr + nels_to_copy > dest_rgn_end_ptr) 



if 
( 



! r_grow_region_builder 
( 

RJTurRB, 

dest_rgnjptr - R_CurRB- >rrb_RgnData + nels_to_copy 

) 



) 



return FALSE ; 
dest_statejptr = R_CurRB->rrb_StateData ; 
dest_rgn_ptr = R CurRB->rrb RgnData; 

} 

memcpy 

dest_rgn_ptr, 
src_rgn_ptr, 

nels_to_copy * sizeof (R_Int) 

); 

dest_rgn_ptr += nels_to_copy ; 

if (Ifirst) 

{ 

memcpy 
( 

dest_state_ptr, 
src_state_ptr, 

nels_to_copy * sizeof (unsigned char ) 

) ; 

) 

else 

{ 

k r e_B Ca 8£ tpj^eopy s rc_s tat e_end_p t r ; 
dest_state_ptr += nels_to_copy; 
switch (i) 
{ 

default: 

for {; i > 10; i--) 
( 

tfifndef RB_USE_L00KUP 

* <dest_state_ptr - i) = (* (src_state_ptr - i) & RB_CUR_S TATE_MAS K ) | 

(*(src_state_ptr - i) >> RB_STATE_SIZE) ; 

tfelse 

* <dest_state_ptr - i) = r_shif t_and_dup [* (src_state_ptr - i)); 

tfendif 

} 

/* FALLTHROUGH 1 ! */ 
case 10: 
tfifndef RB_USE_LOOKUP 

* (dest_state_ptr - 10)= ( * (src_state_ptr - 1 0 ) &RB_CUR_STATE_MAS K ) | 

(Msrc_state_ptr - 10) » RB_STATE_SIZE) ; 

tfelse 

* (dest_state_ptr - 10) = r_shift and_dup [* (src_state_ptr - 10)); 

ttendif 

/* FALLTHROUGH! ! */ 
case 9: 
ttifndef RBJJSE_LOOKUP 

* (dest_state_ptr - 9) = (* (src_state_ptr - 9) & RB_CUR_STATE_MASK) | 

(* (src_state_ptr - 9) >> RB_STATE_SIZE) ; 

tfelse 

* (dest_state_ptr - 9) *= r shif t_and_dup (* (src_state_ptr - 9)]; 

tfendif 

/* FALLTHROUGH I ! */ 
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case 8: 
Hifndef RB_USE_LOOKUP 

* (dest_state_ptr - 8) = {* (src_state_ptr - 8) & RB_CUR_STATE_MAS K ) | 

(* (src_scate_ptr - 8) >> RB_STATE SI2E) ; 

Helse 

Mdest_state_ptr - 8) = r_shift_and dup(* (src_state_ptr - 8)); 

Hendif 

/* FALLTHROUGH! ! */ 
case 7: 
Hifndef RBJJSE_LOOKUP 

Mdest_state_ptr - 7)= ( * (src_state_ptr - 7) & RB_CUR_STATE_MASK) | 

(* (src_state_ptr - 7) >> RB_STATE_SIZE) ; 

Helse 

* (dest_state_ptr - 7) = r_shif t_and_dup (* (src_state_ptr - 7) ) ; 

Hendif 

/* FALLTHROUGH! ! */ 
case 6: 
H ifndef R_USE_LOOKUP 

* (dest_state_ptr - 6) = ( * (src_state_ptr - 6) & RB_CUR_STATE_MAS K ) | 

{* (src_State_ptr - 6) >> RB_STATE_SIZE) ; 

Helse 

* (dest_state_ptr - 6) = r_shif t_and_dup ( * (src_statejptr - 6)]; 

Hendif 

/* FALLTHROUGH! ! */ 
case 5: 
Hifndef RB_USE_LOOKUP 

* (dest_state_ptr - 5) = ( * (src_state_ptr - 5) & RB_CUR_STATE_MASK) | 

<* (src_state_ptr - 5) >> RB_STATE_SIZE) ; 

Helse 

* (dest_state_ptr - 5) = r_shif t_and_dup {* (src_statejptr - 5)]; 

Hendif 

/* FALLTHROUGH! ! */ 
case 4 : 
Hifndef RB_USE_LOOKUP 

Mdest_state_ptr - 4) = (* (src_state_ptr - 4) & RB_CUR_S TATE_MAS K ) | 
^ (Msrc_state_ptr - 4) >> RB_STATE_SIZE) ; 

Helse 

Mdest_state_ptr - 4) = r_shif t_and_dup [* (src_state_ptr - 4)]; 

Hendif 

/* FALLTHROUGH! ! */ 
case 3 : 
Hifndef RB_USE_LOOKUP 

Mdest_scate_ptr - 3) = (* (src_state_ptr - 3) & RB_CUR_STATE_MASK) | 

(* (src_state_ptr - 3) >> RB STATE_SIZE) ; 

Helse 

* (dest_state_ptr - 3) = r_shif t_and_dup [* (src_state_ptr - 3)); 

Hendif 

/* FALLTHROUGH! ! */ 
case 2: 
Hifndef RB_USE_LOOKUP 

* (dest_state_ptr - 2) = ( * (src_state_ptr - 2) & RB_CUR_STATE_MASK) | 

(* (src_state_ptr - 2) » RB_STATE_SIZE) ; 

Helse 

* (dest_state_ptr - 2) = r_shif t_and_dup I* (src_state_ptr - 2)); 

Hendif 

/* FALLTHROUGH! ! */ 
case 1: 
Hifndef RB_USE_LOOKUP 

*(dest state_ptr - l) = (* (src_state_ptr - 1) & RB_CUR_S TAT E_MAS K ) | 

(Msrc_state_ptr - 1) >> RB_STATE_SIZE) ; 



Helse 
Hendif 



* (dest_state_ptr - 1) « r_shif t_and_dup {* (src_state_ptr - 1)); 

/* FALLTHROUGH! ! */ 
case 0: 

/* FALLTHROUGH! ! */ 
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/* 

* Finally, we set the number of elements of the latest region 

* builder. We also return the updates row variable. 
*/ 

R_CurRB->rrb_Nels = dest_rgn_ptr - R_CurRB- >rrb_RgnData ; 
*row_ptr = row; 
return TRUE ; 

} 

flendif 
/* 

* r_check_rgn_buf_len 
* 

* This function checks to see if the static region buffer is large enough. 

* If it isn't then it is reallocated to make it large enough. 
* 

* Parameters: 

* size The required size of the r_RegBuf array. 

* Returns: 

* TRUE on success, FALSE on failure. 
V 

static int 
r_check_rgn_bu f _1 en 
( 

int size 

> 
{ 

ASSERT (size >= 0) ; 

if (size > r RgnBuf Size) 

{ 

int new_buf_size; 
R_Int *new_buf; 

new_buf_size = max(size, r_RgnBufSize * 2); 

new_buf = (R_Int *) malloc (new_buf_size * sizeof (R_Int) ) ; 

if (new_buf == NULL) 

if (reftgnBuFAtySEtfULL) 

{ 

memcpy (newjbuf , r_RgnBuf, r_RgnBufSize * sizeof (R_Int) ) ; 
f ree (r_RgnBuf ) ; 

) 

r_RgnBuf = new_buf; 
r_RgnBufSize = new buf size; 

) " " 

return TRUE; 

} 

/* 

* R_init_region_with_rect 
* 

* This function initialises a R_Region structure to represent a rectangular 

* region. It is assumed that the region is currently uninitialised. 

* Parameters: 

* rgn A pointer to the R_Region to be initialised. 

* rect A pointer to an IntXYMinMax structure representing 

* the rectangular area requiring an equivalent region 

* description. 

* Returns: 

* TRUE on success, FALSE on failure. 
V 

int 

R_init_region_with_rect 
( 

R_Region *rgn, 
IntXYMinMax »rect 
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{ 

R_Int *rgn_data; 

ASSERT(rect->X.Min <= rect ->X .Max) ; 
ASSERT { rect - >Y .Min <= rect->Y.Max) ; 



rgn->rr_BBox = *rect; 
rgn_data = (R_Int *)malloc(9 
if (rgn_data == NULL) 
{ 

return FALSE; 

) 



* sizeof (R Int) ) ; 



rgn_data (0 
rgn_data (1 
rgn_data [2 
rgn_data (3 
rgn_data (4 
rgn_data [5 
rgn_data (6 
rgn_data(7 
rgn_data (8 
rgn->rr_RgnData = rgn_data; 
rgn->rr_RgnDataSize = 9; 
return TRUE; 



R_NEXT_IS_Y; 
rect ->Y. Min ; 
rect ->X. Min ; 
rect- >X. Max + 
R_NEXT_IS_Y; 
rect ->Y. Max + 
rect ->X. Min ; 
rect->X.Max + 
R EOR; 



* R_region_with_region 
* 

* This function initialises a R_Region structure to represent a the region 

* passed as an argument. It is assumed that the region is currently 

* uninitialised. 



Parameters: 

rgn A pointer to the R_Region to be initialised. 

src_rgn A pointer to an R_Region structure representing 

the region to which this region is to be initialised. 

Returns: 

TRUE on success, FALSE on failure. 



int 



R_init region_with_region 
( 



R_Region 
R_Region 



*rgn, 
*src_rgn 



R Int 



*rgn_data; 



rgn->rr_BBox = src_rgn->rr_BBox; 

rgn_data = (R_Int *) malloc (src_rgn- >rr_RgnDataSize * sizeof (R_Int) ) ; 
if (rgn_data == NULL) 

{ 

return FALSE; 



memcpy 
( 



) 



rgn_data , 

src_rgn- >rr_RgnData , 

src_rgn->rr_RgnDataSize * sizeof (R_Int) 



rgn->rr_RgnData = rgn — data; 

rgn->rr_RgnDataSize » src_rgn- >rr_RgnDataSize ; 
return TRUE; 
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R_reg ion_wi th_t rans lated_reg ion 

This function initialises a R_Region structure to represent a the region 
passed as an argument translated by delta. It is assumed that the region 
is currently uninitialised. 

Parameters : 

rgn A pointer to the R_Region to be initialised. 

src_rgn A pointer to an R_Region structure representing 

the region to which this region is to be initialised, 
delta A pointer to a IntXY structure representing the 

translation required. 

Returns : 

TRUE on success, FALSE on failure. 

*/ 
int 

R_init_region_with_translated_region 
( 

R_Region *rgn, 
R_Region *src_rgn, 
IntXY *delta 



void 



R_Int *rgn_data ; 
R_Int *src_data; 

rgn->rr_BBox.X.Min = src_rgn->rr_BBox.X .Min + delta->X; 

rgn ->rr_BBox. X.Max = src_rgn->rr_BBox.X .Max + delta->X ; 

rgn->rr_BBox.Y.Min = src_rgn->rr_BBox. Y .Min + delta->Y; 

rgn->rr_BBox. Y.Max = src_rgn->rr_BBox. Y .Max + delta->Y; 

rgn_data = (R_Int *) malloc (src_rgn->rr_RgnDataSize * sizeof (R_Int) ) ; 

if (rgn_data == NULL) 

{ 

return FALSE; 
irc_data = src_rgn->rr_RgnData,- 

for (int i = 0; i < src_rgn->rr_RgnDataSize ; i++) 

if (src_data(i) R NEXT IS Y) 
{ " " " 

rgn_data[i) = src_data[i]; 

i++; 

rgn_data{i) = src_data[i) + delta->Y; 
continue; 

) 

else if <src_data(i] == R_EOR) 
rgn_data[i) = src_data[i) ; 

else 

rgn_data[i) = src_data[i) + delta- >X; 

} 

rgn->rr_RgnData = rgn_data; 

rgn->rr_RgnDataSize = src_rgn->rr_RgnDataSize ; 
return TRUE; 



R_empty_region 

Deallocates the region data allocated for a region. Only the 
data is freed. The R_Region structure itself is not. 

Parameters: 

rgn The region whose region data is to be deallocated. 

Returns : 

Nothing . 
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R_empty region 
( 

R_Region *rgn 

) 
{ 

if (rgn != NULL && rgn- >rr_RgnData != NULL) 
{ 

free (rgn- >rr_RgnData) ; 
rgn->rr_RgnData = NULL; 

} 

} 

Hifndef R_USE_NEW_IMP 
/* 

* Reunion 
* 

* This function inits a R_Region structure to represent the union 

* of it's two arguments. 
* 

* Parameters: 

* rgn The R_Region to be initialised. 

* rl A R_Region ptr representing the first region. 

* r2 A R_Region ptr representing the second region. 

* Returns 

* TRUE on success, FALSE on failure. 
*/ 

int 

Reunion 
( 

R_Region *rgn, 
R_Region *rl, 
R_Region *r2 

) 
{ 

R_lnt *rl_dat; 
R_Int *r2_dat; 
int overlap_f lags; 

union_tot++; 

if ( !BB_intersect_test (&rl->rr BBox, &r2->rr_BBox, &overlap_f lags) ) 
{ 

/* 

* The bounding boxes don't intersect. This means we can do the 

* union very easily, simply by copying data from the two regions. 

* We malloc a new region data array of size rl->rr_RgnDataSize + 

* r2->rr_RgnDataSize - 1. This is the maximum possible size of 

* resulting region. Not all of this memory will be utilised if 

* the two regions being combined have rows with the same y coordinate 

* (R_NEXT_IS_Y marker is not duplicated) . 
*/ 

rgn->rr_RgnDataSize = rl->rr_RgnDataSize + r2->rr_RgnDataSize - 1; 
rgn->rr_RgnData = (R_Int *)malloc(rgn->rr_RgnDataSize * 

sizeof (R_Int) ) ; 

if (rgn->rr_RgnData == NULL) 

( 

return FALSE ; 

) 

/* 

* Now, check to see if the regions overlap in y... 
*/ 

if ( ! (overlap_f lags & BB_INTERSECT_OVERLAP_Y) ) 



{ 



* The regions don't overlap in y. We simply copy one region 

* and then another into the array we malloced. We ensure 

* that rl points to the region with the smallest y coordinate. 
*/ 

if (r2->rr BBox.Y.Min < rl->rr BBox.Y.Min) 
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{ 

R_Region *tmp; 
tmp = rl; 
rl = r2; 
r2 = tmp ; 

} 

memcpy 
< 

rg n - > r r_RgnDa t a , 
rl - >rr_RgnDa ta , 

(rl->rr_RgnDataSize - 1) * sizeof (R_Int ) 

) ; 

memcpy 
( 

rgn->rr_RgnData + rl->rr_RgnDataSize - 1, 
r2->rr_RgnData, 

r2->rr_RgnDataSize * sizeof (R_Int) 

); 

ASSERT ( rgn- >rr_RgnData [rgn->rr_RgnDataSize - 1] == R_EOR) ; 



R Int 


*rl_tmp; 


R Int 


*r2_tmp; 


R_Int 


♦dest; 


R_Int 


min_row; 


int 


rl_done ; 


int 


rl_consumed; 


int 


r2_consumed; 


int 


num_written; 


/* 





* The bboxes overlap in y but not in x. We simply go row 

* by row through each region and memcpy the individual rows as 

* appropriate. We ensure that rl points to the region with 

* the smallest x coordinate. 
*/ 

if (r2->rr_BBox.X.Min < rl->rr_BBox .X .Min) 

{ 

R_Region *tmp; 
tmp = rl; 
rl = r2; 
r2 = tmp; 

) 

rl_dat = rl->rr_RgnData; 
r2_dat = r2- >rr_RgnData; 
dest = rgn->rr_RgnData; 
rgn->rr_RgnDataSize = 0; 
rl_consumed = 0; 
r2_consumed = 0; 

while (*rl dat 1= R EOR && *r2 dat U R EOR) 
{ 

ASSERT (*rl_dat == R_NEXT_IS_Y) ; 

ASSERT (*r2_dat == R_NEXT_IS_Y) ; 

min_row = min(rl_dat [1] , r2_dat [1] ) ; 

rl_done = FALSE; 

if (rl dat(l] min row) 

{ 

/* 

* We need to emit rl . We therefore need to find where 

* the next row (if any) starts. When we do this we 

* recall that a y value _must be followed by at least 

* two x values . . 
*/ 

rl_tmp = rl_dat + 4; 

while (*rl_tmp != R_NEXT_IS_Y && *rl_tmp ! = R_E0R) 

rl_tmp++; 
num_written = rl_tmp - rl_dat; 

memcpy (dest, rl_dat, num_written * sizeof (R_Int) ) ; 
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dest num_written; 
rl_consumed += num_written; 
rgn->rr_RgnDataSize += num_written; 
rl_dat = rl_tmp; 
rl_done = TRUE; 

) 

if (r2_dat[l) == min_row) 
{ 

/* 

* We need to emit rl . We therefore need to find where 

* the next row (if any) starts. When we do this we 

* recall that a y value _must be followed by at least 

* two x values. If rl ' s current row has already been 

* emitted for this y value, we do _not_ emit the 

* R NEXT_IS_Y marker or the y value itself. 
*/ ~ 

if (rl_done) 

{ 

r2_dat += 2; 

r2_tmp = r2_dat ♦ 2 ; 

r2_consumed += 2; 

} 

else 

( 

r2_tmp = r2_dat + 4 ; 

} 

while (*r2_tmp != R_NEXT_IS_Y && *r2_tmp != R_EOR) 

r2_tmp++; 
num_written = r2_tmp - r2_dat; 

memcpy (dest , r2_dat, num_written * sizeof (R_Int ) ) ; 
dest += num_written; 
r2_consumed += num_written; 
rgn->rr_RgnDataSize += num_written; 
r2 dat = r2 tmp; 

} 

(*rl_dat != R_EOR ) 
/• 

* rl is the last region left standing. We memcpy 

* the remainder of the region (including the 

* R_EOR marker) to the destination. 
V 

ASSERT ( r2_consumed == r2->rr_RgnDataSize - 1) ; 

memcpy 

( 

dest, 
rl_dat, 

(rl->rr_RgnDataSize - rl_consumed) * sizeof (R_Int) 

) ; 

rgn->rr_RgnDataSize += (rl->rr_RgnDataSize - rl_consumed) ; 



/* 

* r2 is the last region left standing. We memcpy 

* the remainder of the region (including the 

* R EOR marker) to the destination. 
*/ ~ 

ASSERT (rl_consumed == rl->rr_RgnDataSize - i) ; 

memcpy 

( 

dest, 
r2_dat, 

(r2->rr_RgnDataSize - r2_consumed) * sizeof (R_Int) 

); 

rgn->rr_RgnDataSize ♦ = (r2->rr_RgnDataSize - r2_consumed) ; 
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ASSERT 
( 

rgn->rr_RgnData (rgn->rr_RgnDataSi2e - 1) == R_EOR 

) ; 

) 



R_Int min_row; 

int dest_size; 

unsigned char *rgn_bld_stat ,- 

R_Int *rgn_bld_dat ; 

int i; 

int in_run; 

int done_rl_in_row; 

union_full++; 
/* 

* The two regions _do_ overlap in x _and y. We therefore have 

* &@gd@nd.bw& Q@setWerk_RBg$d&BUld@dBgs£bec«ndens€Sr&hgta^@ 

* regarding the currently active regions as we progress through 

* the rows of each region. After any rows relevent to a y-coord 

* are added to the region builder, we examine the state of each 

* pixel run in the region builder. If the addition of the row(s) 

* for the y-coord have caused a transition to or from 0, then 

* the pixel run is emitted. However, the first thing we do is 

* ensure the current region builder is empty. 
*/ 

rl_dat = rl->rr_RgnData; 
r2_dat = r2->rr_RgnData; 
R_CurRB->rrb_Nels = 0; 
dest_size = 0; 
/* 

* We are now ready to loop through the data of both regions. 

* We continue building the new region whilst there is data 

* remaining in either of the two regions. 
*/ 

while (*rl_dat != R_E0R || *r2_dat != R_EOR) 
{ 

ASSERT (*rl_dat R_NEXT_IS_Y || *rl_dat == R_E0R) ; 
ASSERT ( * r2_dat == R_NEXT_IS_Y jj *r2_dat == R^EOR) ; 
if (*rl_dat == R_EOR) 

min_row = r2_dat(l]; 
else if (*r2_dat == R_EOR) 

min_row = rl_dat[l]; 

else 

min_row = min (rl_dat [1) , r2_dat(U); 
done_rl_in_row = FALSE; 

if (*rl_dat != R_EOR && rl_dat(l) ==vmin_row) 
{ 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if ( !R_add_row_to_region_builder (&rl_dat, 0x1, TRUE) ) 

return FALSE; 
done_rl_in_row = TRUE; 

) 

if («r2 dat »= R EOR && r2 dat 111 == min row) 



{ 



/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
•/ 

if (IR add row to region builder (&r2 dat, 0x2, !done rl in row)) 
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return FALSE; 

) 

/* 

* Now, we generate the output row for the input rows. 
V 

if (!r check rgn buf len(dest size + 2)) 
( - - - 

return FALSE; 

} 

r_RgnBuf [dest_size++] = R_NEXT_IS_Y; 
r_RgnBuf [dest_size++] = minrow; 
rgn_bld_stat = R_Cu r RB - > r rb_S t a t eOa t a ; 
rgn_bld_dat = R_CurRB->rrb_RgnData; 
in_run = FALSE; 

for (i = R CurRB->rrb Nels; i > 0; i--) 
( 

if 
( 

*rgn_bld_stat > 0 

&& 

( 

(*rgn_bld_stat & RB_CUR_S T ATEJ4AS K ) == 0 
II 

(*rgn_bld_stat & RB_PREV_STATE_MASK) == 0 

) 

) 
( 

/* 

* We have to emit a run here, if we're not already 

* in one . . 
*/ 

if { ! in run) 

( 

if ( ! r_check_rgn_buf_len (dest_size + l) ) 

{ 

return FALSE; 

) 

r_RgnBuf [dest_size++] = *rgn_bld_dat ; 
in_run = TRUE; 

) 

} 

else 
{ 

if (in_run) 

{ 

/* 

» we've come to the end of a run. We output the next 
element to end it. 

*/ 

if (!r_check rgn buf len(dest_size + 1)) 
{ " " 

return FALSE; 

) 

r_RgnBuf (dest_size++] = *rgn_bld_dat; 

) 

in_run = FALSE; 

) 

rgn_bld_stat++ ; 
rgn bid dat++; 

) ~ " 

if (r RgnBuf (dest_size - 2] == R NEXT_IS_Y) 
{ 

/* 

* We didn't output anything for these input rows. Rewind.. 
•/ 

dest size -= 2; 

) 
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/* 

* We've completed constructing the data for the region. We 

* make a copy the constructed data from the permanent buffer to 

* an exactly fitting buffer. 
*/ 

rgn->rr_RgnData = (R_Int * ) malloc (++dest_size * sizeof (R_Int ) ) ; 
if (rgn->rr_RgnData == NULL) 

( 

return FALSE; 

} 

memcpy (rgn->rr_RgnData, r_RgnBuf, (dest_size - 1) * sizeof (R_lnt) ) ; 
rgn->rr_RgnData [dest_size - 1J = R_EOR; 
rgn->rr_RgnDataSize = dest_size; 
ASSERT(rgn->rr_RgnDataSize >= 9) ; 

/* 

* We now do a bounding box union of the two component bboxes and place 

* the result in the new region. 
*/ 

BB_union(&rl->rr_BBox, &r2->rr BBox, &rgn->rr BBox) ; 
/* 

* Done! We can get out.. 
*/ 

return TRUE; 



* R_union_equals 
* 

* This function basically implements a rl union= r2 type operation. Ie 

* rl union r2 is calculated and the result returned in rl . 
# 

* Parameters: 

* rl A pointer to an R_ Region. This represents 

* the first half of the union, and is also used to return 

* the eventual result. 

* r2 A pointer to an R_Region. This represents the second 

* half of the union. 

* Returns: 

* TRUE on success, FALSE on failure. 
V 

int 

R_union_equals 
( 

R_Region *rl, 
R_Region *r2 



R_Reg i on ne w_r g n ; 

if (rl->rr_RgnData == NULL) 

return R_init_region_with_region (rl , r2) ; 
if ( !R_union (&new_rgn, rl, r2) ) 

return FALSE; 
R_empty_region (rl) ; 
*rl = new_rgn,- 
return TRUE ; 



* R_intersection 
* 

* This function inits a R_Region structure to represent the intersection 

* of it's two arguments. 
* 

* Parameters: 

* rgn A R_Region ptr to the R_Region structure to be initialised 

* rl A R_Region ptr representing the first region. 

* r2 A R_Region ptr representing the second region. 
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* Returns 

* TRUE on success, FALSE on failure. 
*/ 

int 

R_intersection 
( 

R_Region *rgn, 
R_Region *rl, 
R_Region *r2 



R_Int *rl_dat; 
R_Int *r2_dat; 
int overlap_f lags ; 



int_tot++; 

rgn- >rr_RgnData = NULL; 

if ( !BB_intersect_test (&rl->rr_BBox, &r2->rr_BBox, 

i 



&overlap_f lags) ) 



* The bounding boxes don't intersect. This means that the regions 

* don't intersect. Therefore, we simply set rgn->rr_RgnData to NULL 

* (signifying an empty region) and get out.. 



return TRUE; 

) 

R_Int 
int 

unsigned char 

R_Int 

int 

int 

int 

IntXYMinMax 
int full++; 



min_row; 
dest_size; 
*rgn_bld_stat ; 
*rgn_bld_dat ; 

i; 

in_run; 

done_r l_in_row ; 
new_bbox; 



The two regions _do_ overlap in x _and y. We therefore have 
to do a bit more work in calculating the intersection of the two 
regions. We use the R_RegionBuilder struct to store state 
regarding the currently active regions as we progress through 
the rows of each region. After any rows relevent to a y-coord 
are added to the region builder, we examine the state of each 
pixel run in the region builder. If the addition of the row(s) 
for the y-coord have caused a transition to or from 0x3, then 
the pixel run is emitted. 

t 

Initialise the new_bbox structure for determining the new bounding box. 



*/ 
/* 

4 

*/ 

new_bbox.X .Min = R_ 

new_bbox. Y.Min = R_ 

new_bbox. X.Max = R_ 

new bbox. Y.Max = R 



I NT_MAX_V ALUE 
INT_MAX_VALUE 
INT_MIN_VALUE 
INT MIN VALUE 



* The next thing we do is ensure the current region builder is empty, 

* and set up pointers into the region data of the two regions. 
*/ 

rl_dat = rl->rr_RgnData ; 
r2_dat = r2->rr_RgnData ; 
R_CurRB->rrb_Nels = 0; 
dest_size = 0; 
/* 

* We are now ready to loop through the data from both regions. Notice 
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* that we only keep looping whilst _both_ regions have some data left 

* to give. As soon as either of the region's data has been exhausted, 

* then we stop as the intersection region has already been calculated 

* and is sitting in the rgn buf . 
V 

while (*rl_dat ! = R_EOR && *r2_dat != R_EOR) 
{ 

ASSERT ( *rl_dat == R_NEXT_IS_Y || *rl_dat == R_EOR) ; 
ASSERT ( *r2_dat == R_NEXT_IS_Y jj *r2_dat == R_EOR) ; 
if (*rl_dat == R_EOR) 

min_row = r2_dat[l]; 
else if (*r2_dat == R_EOR) 

n:\in_row = rl_dat(l]; 

else 

min_row = rain (rl_dat [1) , r2_dat[l)); 
done_rl_in_row = FALSE; 

if (*rl_dat != R_EOR && rl_dat[l] == min_row) 
{ 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if ( !R_add_row_to_region_builder (&rl_dat, 0x1, TRUE) ) 

return FALSE; 
done_rl_in_row = TRUE; 

) 

if (*r2_dat != R_EOR && r2 dat(l] == min_row) 
( 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if ( !R_add_row_to_region_builder (&r2_dat , 0x2, ! done_rl_in_row) ) 
return FALSE ; 

) 

/* 

♦ Now, we generate the output row for the input rows. 
*/ 

if ( !r_check_rgn_buf_len(dest_size + 2)) 
( 

return FALSE; 

) 

r_RgnBuf [dest_size++) = R_NEXT_IS_Y; 
r_RgnBuf [dest_size++] = min_row; 
rgn_bld_stat = R_CurRB- >rrb_StateData ,- 
rgn_bld_dat « R_CurRB->rrb_RgnData; 
in_run = FALSE; 

for (i = R_CurRB->rrb_Nels; i > 0; i--) 
( 

if 
( 

*rgn_bld_stat != (3 | (3 << RB_STATE_SIZE) ) 

&& 

( 

(*rgn bld_stat & RB_PRE V_ST ATE_MAS K ) == 3 
II 

(*rgn_bld_stat & RB_CUR_S TATE_MAS K ) == (3 << RB_STATE_SIZE) ) 

) 
{ 

/* 

* We have to emit a run here, if we're not already 

• in one. . 
*/ 

if ( ! in run) 

{ 

if ( !r_check_rgnj3uf_len(dest_size + D) 

{ 

return FALSE; 
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) 

r_RgnBuf Cdest_size++) = *rgn_ bld_dat ; 
in_run = TRUE; 

newbbox.X .Min = min (new_bbox . X .Min, *rgn_bld_dat ) ; 

) 

} 

else 

{ 

if (in_run) 

{ 

/* 

* We've come to the end of a run. We output the next element 

to end it . 
*/ 

if (!r_check_rgn_buf_len(dest_size + 1)) 
{ 

return FALSE; 

} 

r_RgnBuf (dest_size*- + ) = *rgn_bld_dat ; 

new_bbox. X.Max = max(new_bbox .X .Max, *rgn_bld_dat) ; 

) 

in_run = FALSE; 

) 

rgn_bld_stat++ ; 
rgn_bld_dat++; 

} 

if (r_RgnBuf (dest_size - 2) == R NEXT_IS_Y) 
{ 

/* 

* We didn't output anything for these input rows. Rewind.. 
•/ 

dest_size - = 2; 

) 

else 

{ 

if (min_row < new_bbox. Y .Min) 

new_bbox. Y.Min = min_row; 
else if (min_row > new_bbox. Y .Max) 

new_bbox. Y.Max » min_row; 

} 

} 

/* 

* We've completed constructing the data for the region. Firstly 

* we check to see if we've emitted anything at all. If we have 

* then dest_size must be > 0 . If it isn't we simply free the 

* region we created and get out, as the regions don't really 

* intersect, in spite of their intersecting bounding boxes. 
*/ 

if (dest_size = = 0) 

{ 

return TRUE; 

} 

/* 

* We make a copy the constructed data from the permanent buffer to 

* an exactly fitting buffer. 
*/ 

rgn->rr_RgnData = (R_mt * ) malloc (++dest_size * sizeof (R_Int ) ) ; 
if (rgn->rr RgnData == NULL) 

( 

return FALSE; 

memcpy (rgn- >rr_RgnData, r_RgnBu£, (dest_size - 1) * sizeof (R_Int) ) ; 

rgn->rr_RgnData (dest_size - 1] = R_E0R; 

rgn->rr_RgnDataSize = dest_size; 

ASSERT (rgn- >rr_RgnDataSize >= 9) ; 

/♦ 

* Now, copy across the bounding box. . Before we do this, we subtract 

* 1 from X.Max and Y.Max because of the region format. 
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*/ 

new_bbox . X . Max- - ; 
new_bbox . Y . Max- - ; 
rgn->rr_BBox = new_bbox; 
/* 

* Done! We can get out. 
*/ 

return TRUE; 



* R difference 



* This function inits a RJtegicn structure to represent the difference of 

* it's two arguments. It essentially calculates rl - r2 

* Parameters: 

* rgn A R_Region ptr representing the R — Region to be inited. 

* rl A R_Region ptr representing the first region. 

* r2 A R_Region ptr representing the second region. 

* Returns 

* TRUE on success, FALSE on failure. 
*/ 

int 

R_dif f erence 
( 

R_Region *rgn, 
R_Region *rl, 
R_Region *r2 



R_Int *rl_dat; 
R_Int *r2_dat; 
int over lap_f lags ; 



dif f_tot++; 

rgn->rr_RgnData « NULL; 

if ( !BB_intersect_test {&rl- >rr_BBox, &r2->rr_BBox, &overlap_f lags) ) 
{ 

/* 

* The bounding boxes don*t intersect. This means that rl - r2 

* simply equals rl. We make a copy of the relevant bits and get out. 
*/ " * . ~ 

rgn->rr_BBox = rl->rr_BBox; 
rgn->rr_RgnDataSize = rl- >rr_RgnDataSize ; 

rgn->rr_RgnData = (R_Int Mmalloc (rl->rr_RgnDataSize * sizeof (R_Int) ) 
if (rgn->rr_RgnData == NULL) 

( 

return FALSE ; 

} 

memcpy 
( 

rgn- >rr_RgnData , 
rl->rr_RgnData, 

rl->rr_RgnDataSize * sizeof (R_Int) 

); 

return TRUE; 

} 

R_Int min_row; 

ififtigned char degfc_si fiesta t ; 

R_Int *rgn_bld_dat ; 

int i ; 

int in_run; 

int done_rl_in_row; 

unsigned char m_high; 
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unsigned char m_low; 
IntXYMinMax new_bbox; 

diff full*+; 



The two regions _do_ overlap in x _and y. We therefore have 
to do a bit more work in calculating the difference of the two 
regions. We use the R_RegionBuilder struct to store state 
regarding the currently active regions as we progress through 
the rows of each region. After any rows relevent to a y-coord 
are added to the region builder, we examine the state of each 
pixel run in the region builder. If the addition of the row(s) 
for the y-coord have caused the following transitions - 
rl -> 0 

0 -> r2 

rl + r2 -> r2 
r2 -> rl + r2 

..then the relevent runs are emitted. Firstly, though, 
we ensure the current region builder is empty, 
and set up pointers into the region data of the two regions. 

>/ 

rl_dat = rl->rr_RgnData; 
r2_dat = r2->rr_RgnData; 
R_CurRB->rrb_Nels = 0; 
dest_size = 0; 

/• 

* Initialise the new_bbox structure for determining the new bounding box. 
*/ 

new_bbox.X.Min = 32767; 

new_bbox.Y .Min = 32767; 

new_bbox. X.Max = -32768; 

new_bbox. Y.Max = -32768; 

/* 

* We are now ready to loop through the data from both regions. Notice 

* that we only keep looping whilst rl has data outstanding. When 

* rl's data is consumed, then any transitions made by r2 are 

* irrelevant. 
V 

while (*rl_dat ! = R_EOR) 
{ 

ASSERT (*rl_dat » R_NEXT_IS_Y || *rl_dat == R_E0R) ; 
ASSERT (*r2_dat == R_NEXT_IS_Y || *r2_dat « R_E0R) ; 
if (*rl_dat «« R_E0R) 

min_row = r2_dat[lj; 
else if (*r2_dat == R_E0R) 

min_row = rl_dat{l]; 

else 

min_row = min (rl_dat [1 J , r2_dat[l] ) ; 
done_rl_in_row = FALSE; 

if <*rl_dat != R EOR && rl dattl] = = min row) 
{ 

/• 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
V 

if ( IR_add_row_to_region_builder{&rl_dat, 0x1, TRUE)) 

return FALSE; 
done_rl in row = TRUE; 

} - - - 

if (*r2_dat != R EOR && r2_dattl] == min row) 
{ 

/* 

* The first region is active on this y coord, we add this 

* row to the current region builder. 
*/ 
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• • • 
• • • 

• • • 



• • • 



• • • • 
• ♦ « 

• • « 



• ■ • 
> • • 

• • • 



if ( ! R_add_row_to_region_builder (&r2_dat , 0x2 , !done_rl_in_row) ) 
return FALSE; 

) 

/* 

* Now, we generate the output row for the input rows. 
*/ 

if ( !r_check_rgn_buf_len(dest_size + 2)) 
{ 

return FALSE; 

) 

r_RgnBuf (dest_size++) = R_NEXT_IS_Y; 
r_RgnBuf (dest_size++) = min_row; 
rgn_bld_stat = R_CurRB- >rrb_StateData ; 
rgn_bld_dat = R_CurRB->rrb_RgnData ; 
in_run = FALSE; 

for (i = R_CurRB->rrb Nels; i > 0; i--) 
{ 

m_high = ( *rgn_bld_stat & RB_CUR_S TATE_MAS K ) >> RB — STATE_SI ZE ; 

m_low = *rgn_bld_stat & RB_PREV_STATE_MASK; 

if 



( 



(m_low != l && m_high == 1) 

ii 

(m_low == 1 && m_high ! = 1) 



* We have to emit a run here, if we're not already 

* in one. . 
*/ 

if (!in_run) 

( 

•••• if (!r check rgn_buf_len (dest_size + 1)) 

< 

return FALSE; 

) 

r_RgnBuf [dest_size++) = *rgn_bld_dat ; 
in_run = TRUE; 

new_bbox.X .Min = min (new_bbox.X.Min, *rgn_bld_dat) ; 

} 

) 

else 

{ 

if (in_run) 

{ 

/* 

* We've come to the end of a run. We output the next element 

to end it. 
*/ 

if ( !r_check_rgn_buf_len(dest_size +1)) 
{ 

return FALSE; 

) 

r_RgnBuf [dest_size++J = *rgn_bld_dat ; 
new_bbox.X .Max = max (new_bbox. X.Max, *rgn_bld_dat ) ; 

} 

in run = FALSE; 

} 

rgn_bld_stat++ ; 
rgn_bld_dat + + ; 

} 

if (r_RgnBuf ldest_size - 2) == R_NEXT_IS_Y) . 



{ 



* We didn't output anything for these input rows. Rewind. 
*/ 
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dest size - = 2; 

) 

else 

{ 

if (min_row < new_bbox. Y.Min) 

new_bbox. Y.Min = min_row; 
else if (min_row > new_bbox. Y.Max) 

new bbox. Y.Max = min_row; 

} 

) 

/* 

* We've completed constructing the data for the region. Firstly 

* we check to see if we've emitted anything at all. If we have 

* then dest_size must be > 0 . If it isn't we simply free the 

* region we created and get out, as r2 - rl must be empty. 
V 

if (dest_size == 0) 

{ 

return TRUE ; 

} 

/* 

* We make a copy the constructed data from the permanent buffer to 

* an exactly fitting buffer. 
*/ 

rgn->rr_RgnData = (R_Int Mmalloc (++dest_size * sizeof (R_Int) ) ; 
if (rgn- >rr_RgnData == NULL) 

{ 

return FALSE; 

} 

memcpy (rgn- >rr_RgnData, r_RgnBuf, (dest_size - 1) * sizeof (R_Int) ) ; 

rgn->rr_RgnData [dest_size - 1] = R_E0R; 

rgn->rr_RgnDataSize = dest_size; 

ASSERT (rgn- >rr_RgnDataSize >= 9) ; 

/* 

* Now, copy across the bounding box.. 
*/ 

rgn->rr_BBox - new_bbox; 
/* 

* Done ! We can get out . . 
♦/ 

return TRUE; 

) 

tfendif /* R_USE_NEW_IMP */ 
/* 

* r_grow_f ree_list 

* This function mallocs and adds R_FREE_LIST_GROWTH_SIZE new elements 

* to the front of the region growth free list. 
* 

* Parameters: 

* None . 

* Returns: 

* TRUE on success, FALSE on failure. 
*/ 

int 

r_grow_f ree_list () 

{ 

R_RgnGrowItem *rgi ; 
int i ; 

/* 

* First, malloc the memory. . 
*/ 

rgi 3 (R_RgnGrowItem *) malloc 
( 

R_FREE_LIST_GROWTH_SIZE * sizeof <R_RgnGrowI tern) 

); 

if (rgi == NULL) 
return FALSE; 
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/* 

* Now make the whole block of memory into a list. . 
*/ 

for (i = 0; i < R_FREE_LI ST_GROWTH__S I ZE - 1; i* + ) 
rgi (i) . rrgi_Next = &rgi(i + 1) ; 

/* 

* Now, add it to the front of the free list.. 
*/ 

r 9i (R_FREE_LIST_GROWTH_SIZE - l].rrgi_Next = r_f ree_list ; 
r_free_list = rgi; 
return TRUE; 



R_add_row_to_region_growth_list 

This function adds a row from a R_Region to a linked list comprised of 
R_RgnGrowltem structures. "Adding" implies that the linked list is 
modified such that the state and coordinate information present 
in the list is updated to take into account the new row just added. 
Adding a row has the following properties: 



* If a pixel run in the row does not exist in the list before, 
it is added and it's current state is tagged with the region 
to which the row belongs. The previous state is set to 0, 
indicating that it did not exist before. 

* If a pixel run in the row did exist before, but it's present state 
indicates that it came from the other region then the run 

is retained but it's state is modified to indicate that 
both regions are active at this point. 

* If a pixel run in the row did exist before, and it's present 
state indicates that the current region then the region is 
removed and it's state is modified to indicate that the run is 
now empty. 

* If a pixel run in the row did exist before, and it's present state 
indicates that both regions are currently active then the run 

is retained, but its state is modified to indicate that only the 
other region is active in this run. 



Parameters: 

row_ptr A R_Int ** pointer to the row in the region. Used 
to return the updates row pointer. 

rgn_mask A mask for the region the row comes from. Must 
be either 1 or 2 . 



row = *row_ptr; 
/* 

* Skip over the row's y value at the beginning. 
*/ 

ASSERT ( * row == R_NEXT_IS_Y) ; 
row + = 2; 

ASSERT(*row != R NEXT IS Y && *row 1= R EOR) ; 




t 

add_row_to_region_growth_list 



R_Int 

int 

int 



**row_ptr, 

rgn_mask, 

first 



R_Int 

R_RgnGrowItem 
unsigned char 
int 



* row ; 
*rgi; 

rb_prev_run_state ; 
row_on ; 
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If (r_growth_list == NULL) 
( 

R_RgnGrowI t em * * pt r_next_pt r ; 
/* 

* The growth list is currently empty. Therefore, we simply convert 

* the input row to the region growth list format.. 
V 

row_on = TRUE; 

ptr_next_ptr = &r_growth_list ; 
while (R NOT_END OF ROW (* row)) 
{ 

if (r_free_list == NULL) 
{ 

if ( !r_grow_f ree_list <) ) 
return FALSE; 

} 

rgi = r_free_list; 
*ptr_next_ptr = rgi; 
ptr_next_ptr = &rgi- >rrgi_Next ; 
r_free_list = *ptr_nextjptr; 
rgi->rrgi_RgnData = *row; 
i f ( row_on ) 

rgi->rrgi_StateData = (rgn_mask << RB_STATE_S I ZE ) ; 

else 

rgi->rrgi_StateData = 0; 
row_on = !row__on; 
row++ ; 

) 

*row_ptr = row; 
*ptr_next_ptr = NULL; 
return TRUE; 

} 

R_RgnGrowItem fake_item; 
R_RgnGrowItem *prev_rgi ; 

/* 

* "fake_item n is used as the head of the list. This is so that we _always_ have 

* a valid pointer to the previous item in the list. Only the next pointer and 

* state data are initialised, as these are they only elements which will be 

* referenced. 
V 

fake_item. rrgi_StateData = 0; 

f ake_item, rrgi_Next = r_growth_list ; 

prev_rgi = &fake_item; 

if (first) 

{ 

/* 

* If this is the first row to be added on this particular scanline, 

* then we have to update the existing contents of those elements 

* at the beginning of the growth list which precede (in coords) the 

* first element of the row. "Updating" involves updating the 

* previous state of each element to match the current state. This is 

* because none of the elements were effected by the addition of the 

* new row. 

rgi s r_growth_list ; 

while (rgi != NULL && *row > rgi- >rrgi_RgnData) 
{ 

tfifndef RB_USE_LOOKUP 

rgi->rrgi_StateData = (rgi->rrgi_StateData & RB_CUR_STATE_MASK) | 

(rgi->rrgi_StateData >> RB_STATE_SIZE) ; 

tfelse 

rgi->rrgi StateData = r shif t_and_dup [rgi- >rrgi_StateData] ; 

ttendif 

prev_rgi = rgi; 
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rgi = rgi->rrgi Next; 

) 

) 

else 
{ 

/* 

* This is the second row to be added on this particular scanline. 

* Therefore, we don't need to update the state of the elements 

* preceding (in coords) the first run of the row to be added, as 

* they have already been updated by the first row to be added on 

* this scanline. We simply skip over the unaffected elements. . 
*/ 

rgi = r_growth_list ; 

while (rgi != NULL && *row > rgi- >rrgi_RgnData) 

{ 

prev_rgi = rgi; 

rgi = rgi->rrgi Next; 

) 

} 

if (rgi == NULL) 
{ 

/« 

* We've already exhausted the current growth list. Set the start 

* of the next pixel run to be the max. possible and set the state 

* to be 0. 
*/ 

rb_prev_run_6tate = 0; 

) 

else 
{ 

/* 

* We are still within the current growth list bounds. Set up 

* the run info appropriately. 
*/ 

if (rgi == r_growth_list ) 
rbjprev_run_state = 0; 

else 

rb_prev_run_state » prev_rgi- >rrgi StateData; 

) 

/* 

* We can now start merging the elements of the row with the remaining 

* elements of the growth list. 
*/ 

row_on = TRUE; 

while (R_NOT_END_0F_R0W(*row) ) 
I 

if (rgi == NULL | | *row < rgi->rrgi_RgnData) 
{ 

/* 

* This is the only situation in which we actually have to 

* create a new list element. First, we check that we 

* actually have an element in the free list that we 

* can use in the growth list.. 
*/ 

if (r_free_list == NULL) 
{ 

if (retgrpwFfe8Bj„list 0) 

} 

prev_ rgi->rrgi_Next = r_free_list; 

prev_ rgi = r_free_list; 

r_free_list = r_f ree_list->rrgi_Next; 

prev_rgi->rrgi_Next = rgi; 

/* 

* Now, fill in the data.. 
*/ 

prev_rgi->rrgi_RgnData = *row; 
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if (first) 
{ 

/* 

* We are processing the first region. Therefore, we 

* copy the current state of the run to the lowest 

* RB_STATE_SIZE bits. 
*/ 

ffifndef RB_USE_LOOKUP 

prev_rgi->rrgi_StateData = (rb_prev_run_state & RB_CUR_STATE_MASK) | 

(rb_prev_run_state >> RB_STATE_S I ZE ) ; 

tfelse 

prev_rgi->rrgi_StateData = r_shif t_and_dup (rb_prev_run_state) ; 

ftendif 

} 

else 
( 

/* 

* We are processing the second region. Therefore, the state data 

* has already been copied to the previous state area so we 

* just copy the state. 
*/ 

prev_rgi->rrgi_StateData = rb_prev_run_state ; 

} 

* Now, if the row for the current region is active at this transition, 

* we xor the region mask with the current contents of the new list 

* item. This gives the desired behaviour of making that region active 

* if it is not there already, but turns it off if it is... 
*/ 

if (row_on) 

prev_rgi->rrgi_StateData (rgn_mask << RB_STATE_SIZE) ; 

/* 

* We now move onto the next row element . 

*/ 
row++ ; 

row_on = !row_on; 
continue; 

} 

* If the current row transition point is equal in x position to the current 

* list item's transition point, we advance the row counter to 

* the next position. 
*/ 

if (*row « rgi->rrgi_RgnData) 

{ 

row++ ; 

row_on = !row_on; 

} 

/* 

* We update the current list item to deal with the affects of the 

* current row run . . 
*/ 

rb_prev_run_state = rgi->rrgi_StateData ,- 

if (first) 

{ 

#ifndef RB_USE_LOOKUP 

rgi->rrgi_StateData = (rb_prev_run_state & RB_CUR_STATE_MASK) | 

(rbjprev_run3state >> RB_STATE_SIZE) ; 

ttelse 

rgi->rrgi_StateData = r_shif t_and_dup [rb_prev_run_state] ; 

ftendif 

} 

if (irow_on) 

rgi->rrgi_StateData (rgn mask << RB_STATE_SIZE) ; 

/* 

* We now move onto the next element in the list.. 
*/ 

prev_rgi * rgi; 
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rgi = rgi->rrgi_Next ; 

/• 

* Now, simply update the remainder of the elements in the list.. 
*/ 

if (first) 
{ 

while (rgi != NULL) 
{ 

Hifndef RB_USE_LOOKUP 

rgi->rrgi_StateData = (rgi->rrgi_StateData & RB_CUR_STATE_MASK) 

(rgi->rrgi_StateData >> RB_STATE_SIZE) ; 

ttelse 

rgi->rrgi_StateData = r_shif t_and_dup(rgi->rrgi_StateData] ; 

ftendif 

rgi = rgi->rrgi_Next ; 

j 

/* 

* Now copy "fake_item" ' s next pointer to r_growth_list, as it will have 

* changed if something was added to the head of the list.. 
*/ 

r_growth_list = f akeitem. rrgi_Next ; 
/* " 

* Update the return pointer to the region data.. 
*/ 

*row_ptr = row; 
/* 

* Everything should now be OK.. 
*/ 

return TRUE; 

} 

tfifdef R_USE_NEW_IMP 
/* 

* r_union_test_table 
* 

* A 16-int lookup table which when provided with an unsigned char 

* of the following form xxyy, will provide evaluate the key 

* state transition test of the union construction loop. 

* Note that R_STATE_SIZE _must_ be 2 for this lookup table to 

* work. 
*/ 

int r_union_test_table (16) = { 

0, 1, 1, 1, 

1, 0, 0, 0, 
1, 0, 0, 0, 
1, 0, 0, 0 

); 

/* 

* R_union 
* 

* This function inits a R_Region structure to represent the union 

* of it's two arguments. 
* 

* Parameters: 

* rgn The R_Region to be initialised. 

* rl A R_Region ptr representing the first region. 

* r2 A R_Region ptr representing the second region. 

* Returns 

* TRUE on success, FALSE on failure. 
*/ 

int 

R union 

r 

R_Region *rgn, 
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R_Region *rl, 
R_Region *r2 

R_Int *rl_dat; 
R_lnt *r2_dat; 
int overlap_f lags ; 

union_tot++ ; 

if ( !BB_intersect_test ( fieri ->rr_BBox, &r2->rr_BBox, &overlap_f lags) ) 
{ 

/* 

* The bounding boxes don't intersect. This means we can do the 

* union very easily, simply by copying data from the two regions. 

* We malloc a new region data array of size rl->rr_RgnDataSize + 

* r2->rr_RgnDataSize - 1. This is the maximum possible size of 

* resulting region. Not all of this memory will be utilised if 

* the two regions being combined have rows with the same y coordinate 

* (R_NEXT_IS_Y marker is not duplicated) . 
*/ 

rgn->rr_RgnDataSize = rl- >rr_RgnDataSize + r2- >rr_RgnDataSize - 1; 
rgn->rr~RgnData = (R_Int *) malloc (rgn->rr_RgnDataSize * 

sizeof (R_Int) ) ; 

if (rgn->rr_RgnData == NULL) 

{ 

return FALSE; 

* Now, check to see if the regions overlap in y. . . 
*/ 

if ( ! (overlap_f lags & BB_INTERSECT_OVERLAP_Y) ) 
{ 

/* 

* The regions don't overlap in y. We simply copy one region 

* and then another into the array we malloced. We ensure 

* that rl points to the region with the smallest y coordinate. 
*/ 

if (r2->rr_BBox.Y.Min < rl->rr_BBox. Y.Min) 
( 

R_Region *tmp; 
tmp = rl; 
rl = r2; 
r2 = tmp; 

) 

memcpy 
( 

rg n - > r r_RgnDa t a , 
rl->rr_RgnData, 

(rl->rr RgnDataSize - 1) * sizeof (R_Int) 

); 

memcpy 
( 

rgn->rr_RgnData + rl- >rr_RgnDataSize - 1, 
r2->rr_RgnData, 

r2->rr_RgnDataSize * sizeof (R_Int) 

); 

ASSERT (rgn- >rr_RgnData [rgn- >rr_RgnDataSize - 1] == R_EOR) ; 

} 

else 
{ 

R_lnt *rl_tmp ; 
R~Int *r2_tmp ; 
R_Int *dest; 
R_Int min_row; 
int rl_done; 
int rl_consumed; 
int r2_consumed; 
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int num written; 

/* 

* The bboxes overlap in y but not in x. We simply go row 

* by row through each region and memcpy the individual rows as 

* appropriate. We ensure that rl points to the region with 

* the smallest x coordinate. 
*/ 

if (r2->rr_BBox.X.Min < rl->rr_BBox.X.Min) 
{ 

R_Region *tmp; 
tmp = rl; 
rl = r2 ; 
r2 = tmp; 

} 

rl_dat = rl->rr_RgnData ; 
r2_dat = r2->rr_RgnData; 
dest = rgn->rr_RgnData; 
rgn->rr_RgnDataSize = 0; 
rl_consumed » 0; 
r2_consumed = 0; 

while (*rl_dat != R_E0R *r2_dat != R_E0R) 
{ 

ASSERT ( * r l_da t == R_NEXT_IS_Y) ; 
ASSERT ( * r2_da t == R_NEXT_IS_Y) ; 
min_row = min(rl_dat [1] , r2_dat (1] ) ; 
rl_done = FALSE; 
if (rl_dat[l) == min_row) 

( 



* the next row (if any) starts. When we do this we 

* recall that a y value _must be followed by at least . 

* two x values . . 
*/ 

rl_tmp ~ rl_dat + 4 ; 

while (*rl_tmp != R_NEXT_IS_Y && *rl_tmp != R_EOR) 

rl_tmp++; 
num_written = rl_tmp - rl_dat; 

memcpy (dest, rl_dat, num_written * sizeof (R_Int ) ) ; 

dest += num_written; 

rl_consumed += num_written; 

rgn->rr_RgnDataSize += num_written; 

rl_dat = rl_tmp; 

rl_done = TRUE ; 

) 

if (r2 dat(l) == min row) 



{ 



/* 

* We need to emit rl. We therefore need to find where 

* the next row (if any) starts. When we do this we 

* recall that a y value _must be followed by at least 

* two x values. If rl ' s current row has already been 

* emitted for this y value, we do _not_ emit the 

* R NEXT_IS_Y marker or the y value itself. 

*/ " 
if (rl_done) 

{ 

r2_dat += 2; 

r2_tmp = r2_dat + 2 ; 

r2_consumed += 2; 

} 

else 

{ 

r2_tmp = r2_dat + 4 ; 

) 

while (*r2_tmp != R_NEXT_IS_Y && *r2_tmp 1= R_EOR) 

r2_tmp++; 
num_written » r2_tmp - r2_dat ; 
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meracpy (dest, r2_dat, num_written * sizeof (R_Int ) ) ; 
dest num_written; 
r2_consumed += num_written; 
rgn->rr_RgnDataSize ♦= num_written; 
r2_dat = r2_tmp; 

} 

) 

if (*rl_dat ! = R_EOR) 
{ 

/* 

* rl is the last region left standing. We memcpy 

* the remainder of the region (including the 

* R_EOR marker) to the destination. 
*/ 

ASSERT (r2_consumed == r2- >rr_RgnDataSize - 1) ; 

memcpy 

( 

dest, 
rl_dat, 

(rl->rr_RgnDataSize - rl_consumed) * sizeof (R_Int) 

); 

rgn->rr_RgnDataSize (rl->rr_RgnDataSize - rl_consumed) ; 

} 

else 
{ 

/* 

* r2 is the last region left standing. We memcpy 

* the remainder of the region (including the 

* R_EOR marker) to the destination. 
V 

ASSERT (rl_consumed == rl->rr_RgnDataSize - 1) ; 

memcpy 

( 

dest, 
r2_dat , 

(r2->rr_RgnDataSize - r2_consumed) * sizeof (R_Int) 

); 

rgn->rr_RgnDataSize (r2->rr_RgnDataSize - r2_consumed) ; 

) 

ASSERT 
( 

rgn->rr_RgnData {rgn->rr_RgnDaeaSize - 1) == R_EOR 

); 

} 

} 

else 

{ 

R_Int min_row; 

int dest_size; 

R_RgnGrowI tern *rgi ; 

R_RgnGrowItem *rgi_tail ; 

int in_run; 

int done_rl_in_row; 

union_full++; 

/* 

* The two regions _do_ overlap in x _and_ y. We therefore have 

* to do a bit more work in calculating the union of the two 

* regions. We use the a list of R_RgnGrowItem structs to store state 

* regarding the currently active regions as we progress through 

* the rows of each region. After any rows relevent to a y-coord 

* are added to the list, we examine the state of each 

* pixel run in the list. If the addition of the row(s) 

* for the y-coord have caused a transition to or from 0, then 

* the pixel run is emitted. 
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rl_dat = rl->rr_RgnData; 
r2_dat = r2->rr_RgnData; 
dest_size = 0; 
/* 

* We are now ready to loop through the data of both regions. 

* We continue building the new region whilst there is data 

* remaining in either of the two regions. 
*/ 

while (*rl_dat != R_E0R || *r2_dat != R_E0R) 
{ 

ASSERT ( * rl_dat == R_NEXT_IS_Y || *rl_dat = = R_E0R) ; 
ASSERT (*r2_dat == R_NEXT_IS_Y || *r2_dat == R_E0R> ; 
if <*rl_dat R_E0R) 

min_row = r2_dat(l); 
else if (*r2_dat R_EOR) 

min_row = rl_dat(l); 

else 

min_row = min (rl_dat (1) , r2_dat(l]); 
done_rl_in_row = FALSE; 

if (*rl_dat ! = R_E0R && rl_dat(l) = = min_row) 
( 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if ( ! R_add_row_to_region_growth_list (&rl_dat , 0x1 , TRUE) ) 

return FALSE; 
done_rl_in_row = TRUE; 

} 

if (*r2_dat != R_E0R r2_dat[l) min_row) 
{ 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if ( ! R_add_row_to_region_growth_list (&r2_dat , 0x2 , 
! done_rl_in_row) ) 
return FALSE ; 

> 

/• 

* Now, we generate the output row for the input rows. 
*/ 

if ( !r_check_rgn_buf_len(dest_size +2)) 
{ 

return FALSE ; 

) 

r_RgnBuf [dest_size++) = R_NEXT_IS_Y; 
r_RgnBuf [dest_si2e++] = min_row; 
in_run = FALSE; 
ttifndef R_NEW_IMP_CONSTRUCTION_LOOP 

for (rgi = r_growth_list ; rgi != NULL; rgi = rgi- >rrgi_Next) 



#if 0 



{ 



ttelse 
Jfendif 



if 
( 

rgi->rrgi_StateData > 0 

&& 

( 

(rgi->rrgi_StateData & RB_CUR_STATE_MASK) 0 
II 

(rgi->rrgi StateData & rb_prev_state_maSK) == 0 

) 

) 

if (r_union_test_table (rgi- >rrgi_StateData) ) 

{ 
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#else 



tiendif 



} 



* We have to emit a run here, if we're not already 

* in one. . 
*/ 

if (!in_run) 

{ 

if ( !r_check_rgn_buf_len(dest_size + 1)) 
{ 

return FALSE; 

} 

r_RgnBuf ldest_size++) = rgi - >rrgi_RgnData ; 
in_run = TRUE; 

) 

) 

else 

{ 

if (in_run) 

{ 

/* 

* We've come to the end of a run. We output the next 

element to end it. 
*/ 

if ( ! r_check_rgn buf_len(dest_size ♦ 1)) 
{ 

return FALSE; 

) 

r_RgnBuf (dest_size++) = rgi->rrgi_RgnData; 

} 

in_run = FALSE ; 

) 

* Not efficient, get rid of it.. 
*/ 

if (rgi->rrgi_Next NULL) 
rgi_tail = rgi; 



rgi = r_growth_list ; 
rgi_tail = rgi; 

while (rgi != NULL && J r_union_test_table (rgi->rrgi_StateData) ) 

rgi = rgi->rrgi_Next ; 
while (rgi •= NULL) 
{ 

if ( !r_check_rgn_buf_len(dest_size + 2)) 

return FALSE; 
r RgnBuf [dest_size++] = rgi->rrgi_RgnData; 
do 
{ 

rgi = rgi->rrgi_Next ; 
} while (rgi » = NULL && r_union_test _table trgi->rrgi_StateData] ) ; 
rgi_tail = rgi; 

r_RgnBuf {dest_size++] = rgi- >rrgi_RgnData; 

do 

{ 

rgi = rgi->rrgi_Next ; 
} while (rgi != NULL && ! r_union_test_t able [rgi- >rrgi_StateData] ) ; 

) 

if (r_RgnBuf (dest_size - 2] == R_NEXT_ISJf) 
{ 

/* 

* We didn't output anything for these input rows. Rewind.. 
*/ 

dest_size -= 2; 

) 

) 

* Now, we've completed using the growth list for constructing tnxs 

* region. Therefore, we add it to the front of the free list, to 
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* be re-used later. 
•/ 

ttifdef R_NEW_IMP_CONSTRUCTION_LOOP 

while (rgi_tail->rrgi_Next != NULL) 
rgi_tail = rgi_tail- >rrgi_Next ; 

ttendif 

rgi_tail->rrgi_Next = r_free_list; 
r_free_list = r_growth_list ; 
r_growth_list = NULL; 
/* 

* We've completed constructing the data for the region. We 

* make a copy the constructed data from the permanent buffer to 

* an exactly fitting buffer. 
*/ 

rgn->rr_RgnData = (R_Int * ) malloc (++dest_size * sizeof (R_Int) ) ; 
if (rgn->rr_RgnData == NULL) 

{ 

return FALSE ; 

) 

memcpy (rgn- >rr_RgnData , r_RgnBuf, (dest_size - 1) * sizeof (R_Int) ) 
rgn->rr_RgnData [dest_size - 1) = R_EOR; 
rgn~>rr_RgnDataSize = dest_size; 
ASSERT (rgn- >rr_RgnDataSize >= 9); 

} 

/• 

* We now do a bounding box union of the two component bboxes and place 

* the result in the new region. 
*/ 

BB_union(&rl->rr_BBox, &r2->rr_BBox, &rgn->rr_BBox) ; 
/* 

* Done l We can get out . . 
*/ 

return TRUE; 

} 

/* 

* R_union_equals 
* 

* This function basically implements a rl union* r2 type operation. Ie 

* rl union r2 is calculated and the result returned in rl . 
* 

* Parameters: 



* rl A pointer to an R_Region. This represents 

* the first half of the union, and is also used to return 

* the eventual result. 

* r2 A pointer to an R_Region. This represents the second 

* half of the union. 

* Returns: 

* TRUE on success, FALSE on failure. 



*/ 
int 

R_union_equals 
( 

R_Region *rl, 
R_Region *r2 

) 
{ 

R_Region new_rgn; 

If (rl->rr_RgnData NULL) 

return R_init_region_with_region (rl , r2) ; 
if (! Reunion (&new_rgn, rl , r2)) 

return FALSE; 
R_empty_region(rl) ; 
*rl a new_rgn; 
return TRUE; 

) 
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* r_intersection_test_table 
* 

* A 16-int lookup cable which when provided with an unsigned char 

* of the following form xxyy, will provide evaluate the key 

* state transition test of the intersection construction loop. 

* Note that R_STATE_SIZE _must_ be 2 for this lookup table to 

* work. 
♦/ 

int r_intersection_test_table (16) = { 

0, 0, 0, 1, 
0, 0, 0 # 1, 



); 



0, 0, 0, 1, 

1, 1, i, o 



/* 

* R intersection 



* This function inits a R_Region structure to represent the intersection 

* of it's two arguments. 
« 

* Parameters: 

* rgn A R_Region ptr to the R_Region structure to be initialised. 

* rl A R_Region ptr representing the first region. 

* r2 A R_Region ptr representing the second region. 

* Returns 

* TRUE on success, FALSE on failure. 

*/ 
int 

R_intersection 
( 

R_Region *rgn, 
R_Region *rl, 
R_Region *r2 



R_Int *rl_dat; 
R_Int *r2_dat; 
int overlap_f lags ; 



int tot++; 



rgn->rr_RgnData = NULL; 

if ( !BB_intersect_test (&rl->rr BBox, &r2->rr_BBox, 
{ 



&overlap_f lags) ) 



* The bounding boxes don't intersect. This means that the regions 

* don't intersect. Therefore, we simply set rgn->rr_RgnData to NULL 

* (signifying an empty region) and get out. . 
*/ 

return TRUE; 



) 

R_lnt 
int 

R_RgnGrowItem 

R_RgnGrowItem 

int 

int 

IntXYMinMax 



mm_row; 

dest_size; 

♦rgi; 

*rgi_tail ; 
in_run ; 

done_rl_in_row ; 
new_bbox; 



int full**; 



* The two regions _do_ overlap in x _and y. We therefore have 

* to do a bit more~work in calculating the intersection of the two 

* regions. We use the R_RegionBuilder struct to store state 

* regarding the currently active regions as we progress through 
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* the rows of each region. After any rows relevent to a y-coord 

* are added to the region builder, we examine the state of each 

* pixel run in the region builder. If the addition of the row(s) 

* for the y-coord have caused a transition to or from 0x3, then 

* the pixel run is emitted. 
*/ 

/* 

* Initialise the new_bbox structure for determining the new bounding box. 
*/ 

new_bbox.X.Min = R_I NT_MAX_ VALUE ; 
new_bbox.Y.Min = R_INT_MAX_VALUE; 
new_bbox. X.Max = R_INT_MIN_VALUE 
new_bbox . Y . Max = R_INT_MIN_VALUE 

/* 

* The next thing we do is ensure the current region builder is empty, 

* and set up pointers into the region data of the two regions. 
*/. 

rl_dat = rl->rr_RgnData; 
r2_dat » r2->rr_RgnData; 
dest_size = 0; 
/• 

* We are now ready to loop through the data from both regions. Notice 

* that we only keep looping whilst _both_ regions have some data left 

* to give. As soon as either of the region 1 s data has been exhausted, 

* then we stop as the intersection region has already been calculated 

* and is sitting in the rgn_buf . 
*/ 

while (*rl_dat != R_EOR && *r2_dat ■ = R_EOR) 
{ 

ASSERT (*rl_dat == R_NEXT_IS_Y || *rl_dat == R_E0R) ; 
ASSERT (*r2_dat = = R_NEXT_IS_Y || *r2_dat == R_E0R) ; 
If (*rl_dat == R_E0R) 

min_row = r2_dat[l]; 
else if (*r2_dat == R_EOR) 

minjrow = rl_dat[l); 

else 

min_row = min (rl_dat [1] , r2_dat[l}); 
done_rl_in_row = FALSE; 

if (*rl_dat 1= R_EOR && rl_dat[l} == min_row) 
{ 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if { !R_add_row_to_region_growth_list (&rl_dat, 0x1, TRUE) ) 

return FALSE; 
done_rl_in_row = TRUE; 

} 

if (*r2_dat != R_EOR && r2_dat(l] == min_row) 
{ 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if ( !R_add_row_to_region_growth_list (&r2_dat , 0x2, ldone_rl_in_row) ) 
return FALSE; 

) 

/* 

* Now, we generate the output row for the input rows. 
•/ 

if (!r_check_rgn_buf_len(dest_size + 2)) 
{ 

return FALSE; 

} 

r_RgnBuf (dest_size++) ■ R_NEXT_IS_Y; 
r_RgnBuf (dest_size++) = min_row; 
in run = FALSE; 
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ffifndef R_NEW_IMP_CONSTRUCTION_LOOP 

for (rgi = r_growth_list ; rgi != NULL; rgi = rgi- >rrgi_Next ) 
{ 

Bif 0 

if 
< 

rgi->rrgi_StateData ! = (3 | (3 << RB_STATE_SIZE) ) 
< 

(rgi->rrgi_StateData & RB_PREV_STATE_MASK) == 3 
II 

(rgi->rrgi_StateData & RB_CUR_STATE_MASK) == 

(3 << RB_STATE_SIZE) 

) 

) 

ttelse 

if (r_intersection_test_table [rgi- >rrgi_StateData] ) 

Hendif 

{ 

* We have to emit a run here, if we 1 re not already 

* in one . . 
*/ 

if ( ! in_run) 

{ 

if { !r_check_rgn_buf_len(dest_size + 1)) 

< 

return FALSE; 

) 

r_RgnBuf [dest_size++] = rgi~>rrgi_RgnData; 
in_run = TRUE; 

new_bbox.X.Min = min (new_bbox.X .Min, rgi- >rrgi_RgnData) ; 

} 

} 

else 

{ 

if (in_run) 

{ 

/* 

* We've come to the end of a run. We output the next element 

to end it. 

*/ 

if ( l r_check_rgn_buf len (deet_size + l) ) 
{ 

return FALSE; 

' ) 

r_RgnBuf {dest_size++] = rgi->rrgi_RgnData ; 

new_bbox. X.Max = max(new bbox. X.Max, rgi- >rrgi_RgnData) ,- 

) 

in run = FALSE; 

) 

/* 

* Not efficient, get rid of it.- 
*/ 

if (rgi->rrgi_Next == NULL) 
rgi_tail = rgi; 

} 

ttelse 

rgi = r_growth_list ; 
rgi_tail « rgi; 

while (rgi != NULL && ! r_intersection_test_table (rgi->rrgi_StateData)) 

rgi = rgi->rrgi_Next ; 
while (rgi ! = NULL) 
{ 

if ( !r_check_rgn_buf_len(dest_size ♦ 2)) 

return FALSE; 
r_RgnBuf (dest_size++) » rgi->rrgi_RgnData; 
new bbox. X. Min « min (new_bbox.X .Min, rgi->rrgi_RgnData) ; 
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do 
{ 

rgi s rgi->rrgi_Next ; 
} while (rgi NULL && r_intersection_test_table [rgi - >rrgi_stateData) ) 
rgi_tail = rgi; 

r_RgnBuf tdest_size++) = rgi->rrgi_RgnData; 

new_bbox. X.Max = max (new_bbox. X.Max, rgi->rrgi_RgnData) ; 

do 

{ 

rgi = rgi->rrgi_Next ; 
} while (rgi != NULL ! r_intersect ion_test_table [rgi- 
>rrgi_StateData] ) ; 

i 

llendif 

if (r_RgnBuf (dest_size - 2] == R_NEXT_IS_Y) 
( 

/* 

* We didn't output anything for these input rows. Rewind.. 
*/ 

dest_size -= 2; 

} 

else 

{ 

if (min_row < new_bbox. Y.Min) 

new_bbox.Y.Min = min_row; 
else if (min_row > new_bbox. Y.Max) 

new_bbox .Y.Max = min_row; 

) 

) 

/* 

* Now, we've completed using the growth list for constructing this 

* region. Therefore, we add it to the front of the free list, to 

* be re-used later. 
*/ 

tfifdef R_NEW_IMP_CONSTRUCTION_LOOP 

while (rgi_tail->rrgi_Next != NULL) 
rgi_tail = rgi_tail->rrgi_Next ; 

#endif 

rgi_tail->rrgi_Next = r_free_list; 
r_free_list = r_growth_list ; 
r_growth_list = NULL; 
/* 

* We've completed constructing the data for the region. Firstly 

* we check to see if we've emitted anything at all. If we have 

* then dest_size must be > 0. If it isn't we simply free the 

* region we created and get out, as the regions don't really 

* intersect, in spite of their intersecting bounding boxes. 
•/ 

if (dest_size == 0) 

{ 

return TRUE ; 

} 

/* 

* We make a copy the constructed data from the permanent buffer to 

* an exactly fitting buffer. 
*/ 

rgn->rr_RgnData = (R_Int Mmalloc (++dest_size * sizeof (R_Int) ) ; 
if (rgn->rr_RgnData == NULL) 

{ 

return FALSE; 

} 

memcpy (rgn- >rr_RgnData , r_RgnBuf, (dest_size - l) * sizeof (R_Int) ) ; 

rgn->rr_RgnData [dest_size - 1) = R_E0R; 

rgn->rr_RgnDataSize = dest_size; 

ASSERT (rgn- >rr RgnDataSize >«= 9); 

/* 

* Now, copy across the bounding box.. Before we do this, we subtract 

* 1 from X.Max and Y.Max because of the region format. 
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*/ 

ne w_bbox . X . Max - - ; 
new_bbox . Y . Max- - ; 
rgn->rr_BBox = new_bbox; 
/* 

* Done! We can get out. 
*/ 

return TRUE ; 



* r_dif ference_test_table 

* A 16-int lookup table which when provided with an unsigned char 

* of the following form xxyy, will provide evaluate the key 

* state transition test of the difference construction loop. 

* Note that R_STATE_SIZE _must_ be 2 for this lookup table to 

* work. 
*/ 

int r_dif f erence_test_table [16] = { 

0, l, 0, 0, 

1. 0, 1, 1, 



0, 1, 0, 0, 
0, 1, 0, 0 



* R_difference 
* 

* This function inits a R_Region structure to represent the difference of 

* it's two arguments. It essentially calculates rl - r2 
* 

* Parameters: 

* rgn A R_Region ptr representing the R_Region to be inited. 

* rl A R_Region ptr representing the first region. 

* r2 A R_Region ptr representing the second region. 

* Returns 

* TRUE on success, FALSE on failure. 
*/ 

int 

R_dif f erence 
( 

R_Region *rgn, 
R_Region *rl, 
R_Region *r2 



R_Int *rl_dat; 
R_Int *r2_dat; 
int overlap_f lags ; 



diff_tot++; 

rgn->rr_RgnData = NULL; 

if ( !BB_intersect_test (&rl->rr_BBox, &r2->rr BBox, &overlap_f lags) ) 
{ ' 
/* 

* The bounding boxes don't intersect. This means that rl - r2 

* simply equals rl . We make a copy of the relevant bits and get out.. 
*/ 

rgn->rr_BBox = rl->rr_BBox; 
rgn->rr_RgnDataSize = rl->rr_RgnDataSize; 

rgn->rr_RgnData o (R_Int *)malloc (rl- >rr_RgnDataSize * sizeof (R_Int) ) ; 
if (rgn->rr_RgnData == NULL) 

{ 

return FALSE; 

) 
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memcpy 
( 



rgn- >rr_RgnData , 
r 1 - >rr_RgnData , 

rl->rr_RgnDataSize * sizeof (R_Int) 



) 

return TRUE ; 



} 

R_Int 
int 

R_RgnGrowItem 

R_RgnGrowItem 

int 

int 

unsigned char 
unsigned char 
IntXYMinMax 



mm_row; 
dest_size ; 
*rgi; 

*rgi_tail; 
in_run; 

done_r l_in_row ; 
m_high; 
m_low; 
new_bbox; 



diff_full++; 



/* 

* The two regions _do_ overlap in x _and y. We therefore have 

* to do a bit more work in calculating the difference of the two 
+ regions. We use the R_RegionBuilder struct to store state 

* regarding the currently active regions as we progress through 

* the rows of each region. After any rows relevent to a y- coord 

* are added to the region builder, we examine the state of each 

* pixel run in the region builder. If the addition of the row(s) 

* for the y-coord have caused the following transitions - 

* rl -> 0 

* 0 -> r2 

* rl + r2 -> r2 

* r2 -> rl + r2 

* ..then the relevent runs are emitted. Firstly, though, 

* we ensure the current region builder is empty, 

* and set up pointers into the region data of the two regions. 
*/ 

rl_dat = rl->rr_RgnData; 
r2_dat = r2->rr_RgnData; 
dest_size = 0; 

/* 

* Initialise the new_bbox structure for determining the new bounding box. 
*/ 

new_bbox.X.Min = 32767; 
new~bbox.Y.Min « 32767; 
new_bbox. X.Max = -32768; 
new_bbox. Y.Max = -32 768; 

/* 

* We are now ready to loop through the data from both regions. Notice 

* that we only keep looping whilst rl has data outstanding. When 

* rl ' s data is consumed, then any transitions made by r2 are 

* irrelevant. 
*/ 

while (*rl_dat != R_EOR) 
{ 

ASSERT { *rl_dat == R_NEXT_IS_Y || *rl_dat == R_EOR) ; 
ASSERT (*r2_dat « = R_NEXT_IS_Y || *r2_dat == R_EOR) ; 
if (*rl_dat == R_EOR) 

min_row = r2_dat[l]; 
else if (*r2_dat == R_E0R) 

min_row = rl_dat [1) ; 

else 

min_row = min(rl_dat (1) , r2_dat [1] ) ; 
done_rl_in_row = FALSE; 

if (*rl_dat != RJBOR && rl dat [1] == min_row) 
{ 
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* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if { !R_add_row_to_region_growth_list (&rl_dat , 0x1, TRUE) ) 

return FALSE; 
done_rl_in_row = TRUE; 

} 

if (*r2_dat ! = R_EOR && r2_dat(l) == min_row) 
{ 

/* 

* The first region is active on this y coord. We add this. 

* row to the current region builder. 
*/ 

if ( !R_add_row_to_region_growth_list (&r2_dat , 0x2, !done_rl_in_row) ) 
return FALSE; 

} 

/* 

* Now, we generate the output row for the input rows. 
*/ 

if ( ! r_check_rgn_buf len (dest size + 2)) 
{ 

return FALSE; 

} 

r_RgnBuf [dest_size++] = R_NEXT_IS_Y; 
r_RgnBuf [dest_size++J = min_row; 
in_run = FALSE; 
ftifndef R_NEW_IMP_CONSTRUCTION_LOOP 

for (rgi = r_growth_list ; rgi != NULL; rgi = rgi->rrgi_Next) 
{ 

flif 0 

m_high = (rgi- >rrgi_StateData & RB_CUR_STATE_MASK) >> RB_STATE_SIZE ; 

m_low = rgi->rrgi_StateData & RB_PREV_STATE_MASK; 

if 

( 

( 

(m_low != 1 && m_high == 1) 

II 

(m_low == 1 && m_high != 1) 

) 

) 

ttelse 

if (r_dif f erence_test_table [rgi->rrgi_StateData] ) 

Sendif 

{ 

/* 

* We have to emit a run here, if we* re not already 

* in one . . 
*/ 

if (!in_run) 

{ 

if ( !r_check_rgn_buf_len(deet_size + 1)) 

{ 

return FALSE; 

} 

r_RgnBuf ldest_size++] = rgi->rrgi_RgnData; 
in_run = TRUE; 

new_bbox.X .Min = min (new_bbox.X.Min, rgi->rrgi RgnData) ; 

) 

else 

{ 

if (in run) 

{ 

/* 

* We've come to the end of a run. We output the next element 
to end it. 



- 106- 



if (!r check rgn but len(dest size + 1)) 

{ " " 

return FALSE; 

) 

r_RgnBuf (dest_size++] = rgi->rrgi_RgnData,- 

new_bbox . X . Max = max (newbbox. X.Max, rgi->rrgi_RgnData) ; 

in_run = FALSE; 

} 

/* 

* Not efficient, get rid of it.. 
*/ 

if (rgi->rrgi_Next == NULL) 
rgi_tail = rgi; 

tfelse 

rgi = r_growth_list; 
rgi_tail = rgi; 

while (rgi != NULL ! r_dif f erence_test_table [rgi->rrgi_StateData) ) 

rgi = rgi->rrgi_Next ; 
while (rgi != NULL) 
{ 

if ( !r_check_rgn_buf__len(dest_size + 2)) 

return FALSE; 
r_RgnBuf (dest_size+ + ) = rgi- >rrgi_RgnData; 
new_bbox.X.Min = min (new_bbox.X .Min, rgi- >rrgi_RgnData) ; 
do 

{ 

rgi = rgi->rrgi_Next ,« 
} while (rgi != NULL r_dif f erence_test_table [rgi->rrgi_StateData] ) ; 
rgi_tail = rgi; 

r_RgnBuf (dest_size++) = rgi->rrgi_RgnData; 

new_bbox . X . Max = max (new_bbox.X .Max, rgi->rrgi_RgnData) ; 

do 

{ 

rgi = rgi->rrgi_Next ; 
} while (rgi != NULL && ! r_dif f erence_test_table (rgi->rrgi_StateData] ) ; 

ttendif 

if (r_RgnBuf tdest size - 2] R NEXT IS Y) 
{ " " " 

/* 

* We didn't output anything for these input rows. Rewind.. 
*/ 

dest size -= 2; 

} 

else 

{ 

if (min__row < new_bbox. Y . Min) 

new_bbox. Y.Min = min_row; 
else if (min_row > new_bbox. Y.Max) 

new_bbox . Y . Max = min_row; 



/• 

* Now, we've completed using the growth list for constructing this 

* region. Therefore, we add it to the front of the free list, to 

* be re-used later. 
*/ 

tfifdef RJ*EW_IMP_CONSTRUCTION_LOOP 

while (rgi_tail->rrgi_Next != NULL) 
rgi_tail = rgi_tail->rrgi_Next ; 

#endif 

rgi_tail->rrgi_Next = r_free_list; 
r_free_list = r_growth_list ; 
r_growth_list = NULL; 
/* 

* We've completed constructing the data for the region. Firstly 
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* we check to see if we've emitted anything at all. If we have 

* then dest_size must be > 0. If it isn't we simply free the 

* region we created and get out, as r2 - rl must be empty. 
*/ 

if (dest_size == 0) 

{ 

return TRUE; 

) 

* We make a copy the constructed data from the permanent buffer to 

* an exactly fitting buffer. 
*/ 

rgn->rr_RgnData = (R_Int * ) malloc (++dest_size * sizeof (R_Int ) ) ; 
if (rgn->rr_RgnData == NULL) 

{ 

return FALSE ; 

) 

memcpy (rgn->rr_RgnData, r RgnBuf, (dest_size - 1) * sizeof (R_Int) ) ; 

rgn->rr_RgnData {dest_size - 1] = R_EOR; 

rgn->rr_RgnDataSize = dest_size; 

ASSERT (rgn->rr_RgnDataSize >= 9) ; 

/* 

* Now, copy across the bounding box. . 
V 

rgn->rr_BBox = new_bbox; 
/* 

* Donel We can get out. . 
V 

return TRUE; 

} 

flendif /* R_USE_NEW_IMP */ 
/* 

* R_compare 
* 

* This function compares two regions and determines if they are the same. 
* 

* Parameters: 

* rgnl The first R_Region. 

* rgn2 The second R_Region. 

* Returns: 

* TRUE if they are the same, FALSE if they aren't. 
V 

int 

R_compare 
( 

R_Region *rgnl, 
R_Region *rgn2 



/* 

* If their region data sizes don't agree, then they aren't the same. 
*/ 

if (rgnl->rr_RgnDataSize != rgn2- >rr_RgnDataSize) 
return FALSE; 

if 
( 

memcmp 
( 

rgnl - >rr_RgnDat a , 
rgn2 * >rr_RgnData , 

rgnl->rr_RgnDataSize * sizeof (R_Int) 

) 



return TRUE ; 
return FALSE; 
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} 

/* 

* r_check_rect_buf_len 

* This function checks to see if the static rectangle buffer is large 

* enough. If it isn f t then it is reallocated to make it large enough. 
* 

* Parameters: 

* size The required size of the r_RectBuf array. 

* Returns: 

* TRUE on success, FALSE on failure. 
*/ 

static int 

r_check_rect_buf _len 
( 

int size 

) 
{ 

ASSERT (size >* 0) ; 

if (size > r_RectBuf Size) 

{ 

int new_buf_size; 
IntXYMinMax *new_buf ; 

new_buf_size = max(size, r_RectBuf Size * 2) ; 
new_buf = (IntXYMinMax *)malloc 

(new_buf_size * sizeof (IntXYMinMax) 

); 

if (new_buf == NULL) 

return FALSE ; 
if (r_RectBuf != NULL) 
{ 

memcpy (new_buf , r_RectBuf, r_RectBuf Size * sizeof (IntXYMinMax) ) ; 
f ree (r_RectBuf ) ; 

) 

r_RectBuf = new_buf; 
r_RectBufSize = new buf size; 

} 

return TRUE; 

} 

flifndef R_USE_NEW_IMP 
/* 

* R_rects_f rom_region 

* This function returns a group of non-overlapping rectangles which 

* together constitute the region. The group of rectangles returned is 

* currently non-optimal as the function uses the R_RegionBuilder structure 

* to store state. A more specific data structure will be required to 

* make the rectangles produced more optimal. 
* 

* Parameters: 

* rgn The region from which a rectangle array is required. 

* rects A pointer to a pointer to a IntXYMinMax structure. Used 

* to return the array. 

* num_rects A pointer to an int. Used to return the number of 

* elements in the array. 

* static_ok This boolean arg is passed as TRUE if a pointer to 

* the r_RectBuf is sufficient. This is TRUE if usefulness of 

* the rectangle data obtained ends before the next call to 

* R_rects_f rom_region (for any region) . FALSE is passed if 

* a newly malloced copy is required. Basically is TRUE is 

* passed the pointer returned must _not_ be freed. 

* Returns : 

* TRUE on success, FALSE on failure. 
*/ 

int 

R_rec t s_f rom_r eg ion 
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R_Region 

IntXYMinMax 

int 

int 



*rgn, 
**rects, 
*num_rects, 
static ok 



R_Int *rgn_data; 

int dest_index; 

int prev_y; 

int prev_x; 

unsigned char *rgn_bld_stat ; 

R_I n t * rgn_bl d_da t ; 

int i; 

int in_run; 

/* 

* Give "nice" defaults for return stuff in cause we fail.. 
*/ 

*rects * NULL; 
*num_rects = 0; 
/* 

* We grab a pointer to the region data for the region and ensure 

* that the current region builder is empty. . 
*/ 

rgn_data = rgn->rr_RgnData; 
if (rgn_data == NULL) 
/* 

* This is an empty region.. Get out.. 
*/ 

return TRUE; 
ASSERT (*rgn_dat a == R_NEXT_IS_Y) ; 
R_CurRB->rrb_Nels = 0; 
/* 

* We add the first row of the region to the region builder. We also 

* store the y-coord of this first row. 
*/ 

prev_y = rgn_data[l); 

if ( !R_add_row_to_region_build£r (trgn_data, 0x1, TRUE) ) 

return FALSE; 
ASSERT <*rgn_data == R_NEXT_IS_Y) ; 
ASSERT (*rgn_data != R_EOR) ; 
/* 

* We are now in a position to loop through the data of the region. 

* We continue until the region data runs out. Basically, we output 

* the runs in the current region builder out as rectangles. Using 

* x-coords from the region builder and y coords of the rows. Then, 

* we add then next row to the region builder. 
*/ 

dest_index = 0; 

while (*rgn_data != R_EOR) 

{ 

ASSERT (*rgn_data == R_NEXT_IS_Y) ; 

rgn_bld_stat = R_CurRB->rrb_StateData; 
rgn_bld_dat = R_CurRB->rrb_RgnData; 
in_run = FALSE; 

for (i = R_CurRB->rrb Nels; i > 0; i-- ) 
{ 

if ( (*rgn_bld_stat & RB_CUR_STATE_MAS K ) > 0) 
{ 

/* 

* We have to emit a run here, if we're not already 

* in one . . 
*/ 

if (!in run) 

{ 

prev_x = *rgn_bld_dat ; 
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in_run = TRUE; 



else 

{ 

if (in_run) 
( 

/* 

* We've come to the end of a run. We output the rectangle 

* right here . . 
V 

if ( !r_check_rect_buf_len(dest_index + 1)) 

return FALSE; 
r_RectBuf (dest_index) .X.Min = prev_x; 
r_RectBuf [dest_index] . Y.Min = prev_y; 
r_RectBuf [dest_index] .X.Max = *rgn_bld_dat - l; 
r RectBuf(dest index++) .Y.Max = rgn data[l) - 1; 

> 

in_run = FALSE; 

} 

rgnjDld_stat++ ; 
rgn_bld_dat++ ; 

} 

/* 

* Now, we advance onto the next row. . 
V 

prev_y = rgn_data[l); 

if { !R_add_row_to_region_builder(&rgn_data, 0x1, TRUE) ) 
return FALSE; 

) 

/* 

* Ok, we have the array of rectangles sitting around. If static_ok 

* is TRUE then we simply set the return pointers and get out. 

* Otherwise, we need to malloc a copy of the r_RectBuf . 
*/ 

*num_rects = dest_index; 
if (static ok) 

{ 

♦rects = r_RectBuf; 

} 

else 
{ 

♦rects = (IntXYMinMax *) malloc (dest^index * sizeof (IntXYMinMax) ) ; 
if (*rects NULL) 
return FALSE ; 

memcpy(* rects, r_RectBuf, dest_index * sizeof (IntXYMinMax) ) ; 

} 

return TRUE; 



se 

R_r e c t s_f r om_r eg i on 

This function returns a group of non- overlapping rectangles which 
together constitute the region. The group of rectangles returned is 
currently non-optimal as the function uses the R_RegionBuilder structure 
to store state. A more specific data structure will be required to 
make the rectangles produced more optimal. 



Parameters: 
rgn 
rects 



The region from which a rectangle array is required. 
A pointer to a pointer to a IntXYMinMax structure. Used 
to return the array. 
num_rects A pointer to an int. Used to return the number of 

elements in the array. 
static_ok This boolean arg is passed as TRUE if a pointer to 

the r_RectBuf is sufficient. This is TRUE if usefulness of 
the rectangle data obtained ends before the next call to 
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* R_rects_f rom_region (for any region) . FALSE is passed if 

* a newly malloced copy is required. Basically is TRUE is 

* passed the pointer returned must _ not_ be freed. 

* Returns: 

* TRUE on success, FALSE on failure. 
*/ 

int 

R_r e c t s_ f rom_ r eg i on 
( 

R_Region *rgn, 

IntXYMinMax **rects, 

int *num_rects, 

int static ok 



R_Int *rgn_data; 

int dest_index; 

R_RgnGrowltem *rgi ; 

R_RgnGrowItem *rgi_tail ; 

int prev_y; 

int prev_x; 

int in_run; 

/* 

* Give "nice" defaults for return stuff in cause we fail.. 
*/ 

*rects = NULL; 
*num_rects = 0; 
/* 

* We grab a pointer to the region data for the region and ensure 

* that the current region builder is empty.. 
*/ 

rgn_data = rgn->rr_RgnData; 
if (rgn_data == NULL) 
/* 

* This is an empty region.. Get out.. 
*/ 

return TRUE; 
ASSERT (*rgn_dat a == R_NEXT_IS_Y) ; 
/* 

* We add the first row of the region to the region builder. We also 

* store the y-coord of this first row. 
*/ 

prev_y = rgn_data[l); 

if ( ! R_add_row_to_region_growth_list ( &rgn_data, 0x1 , TRUE) ) 

return FALSE; 
ASSERT (*rgn_data == R_NEXT_IS_Y) ; 
ASSERT (*rgn data != R_EOR) ; 
/* 

* We are now in a position to loop through the data of the region. 

* We continue until the region data runs out. Basically, we output 

* the runs in the current region builder out as rectangles. Using 

* x-coords 'from the region builder and y coords of the rows. Then, 

* we add then next row to the region builder. 
V 

dest_index = 0; 

while (*rgn data != R EOR) 

{ 

ASSERT (*rgn_dat a == R_NEXT_IS_Y) ; 
in_run = FALSE; 

for (rgi = r_growth_list ; rgi != NULL; rgi « rgi- >rrgi_Next) 

if ( (rgi->rrgi_StateData & RB_CUR_STATE_MASK) > 0) 
{ 

/* 

* We have to emit a run here, if we 1 re not already 

* in one. . 
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*/ 

if (!in_run) 
{ 

prev_x = rgi->rrgi_RgnData; 
in_run = TRUE; 

) 

) 

else 

{ 

if (inrun) 
{ 

/* 

* We've come to the end of a run. We output the rectangle 

* right here . . 
*/ 

if ( !r_check_rect_buf_len(dest_index + 1) ) 

return FALSE; 
r_RectBuf (dest_index] .X.Min = prev_x; 
r_RectBuf (dest_index] .Y.Min = prev_y; 
r_RectBuf [dest_index) .X.Max = rgi->rrgi_RgnData - 1; 
r_RectBuf [dest_index++] .Y.Max = rgn_data[l] - 1; 

) 

in_run = FALSE; 

> 

• /* 

* Not efficient, get rid of it.. 

. ■ */ 

•••• if (rgi->rrgi_Next == NULL) 

# rgi tail = rgi; 

• • • • i 
) 

/* 

* Now, we advance onto the next" row. . 

• -•« . 

P*ev_y = rgn_data[l]; 
4 ,* J if ( !R_add_row_to_region_growth_list Urgn_data, 0x1, TRUE)) 

return FALSE ; 

} 

/* 

• * Now, we've completed using the growth list for constructing the 

)***« * rect list. Therefore, we add it to the front of the free list, to 

* be re-used later. 
*/ 

•• # j rgi_tail->rrgi_Next = r_free_list; 

• r_free_list = r_growth_list ; 
r_growth_list = NULL; 

/* 

* Ok, we have the array of rectangles sitting around. If static_ok 

* is TRUE then we simply set the return pointers and get out. 

* Otherwise, we need to malloc a copy of the r_RectBuf . 
*/ 

*num_rects = dest_index; 
if (static ok) 

{ 

*rects = r_RectBuf; 

} 

else 

♦rects = (IntXYMinMax *) malloc (dest_index * sizeof (IntXYMinMax) ) ; 
if (*rects = = NULL) 
return FALSE; 

memcpy(* rects, r_RectBuf, dest_index * sizeof (IntXYMinMax) ) ; 

i 

return TRUE; 

) 

tfendif /* R_USE_NEW_IMP */ 

/* 

♦ R_translate_region 
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* This function simply translates a region by the delta provided. 

* Parameters: 

* rgn A ptr to the R_Region to be translated. 

* delta An IntXY ptr representing the amount to translate 

* in x and y. 

* Returns: 

* Nothing . 

*/ 
void 

R_translate_region 
( 

R_Region *rgn, 
IntXY *delta 



R_Int *rgn_data; 

BB_translate(&rgn->rr_BBox, delta) ; 
rgn_data = rgn- >rr_RgnData; 

for (int i = 0; i < rgn- >rr_RgnDataSize - 1; i + + ) 
{ 

if (rgn_data(i) == R_NEXT_IS_Y) 
{ 

i++; 

rgn_data{i) += + delta->Y; 
continue; 

) 

rgn_data[i] += delta- >X; 

) 

/*. 

* R_output_region_as_debug_string 
* 

* This function simply outputs a region's data using the debug string 

* functionality. 
* 

* Parameters : 

* rgn_name A string used to output a user-defined name for the 

* region. 

* rgn The region to be output. 

* Returns: 

* Nothing. 

*/ 
void 

R_ou t pu t _r eg i on_a s_debug_s t r i ng 
( 

char * rgn_name , 

R_Region *rgn 

) 
{ 

char buffer (128) ; 
int index; 
int line_len; 

sprintf (buf f er, "\n+Rgn : %s\n n , rgn_name) ; 
OutputDebugString (buf f er) ; 
if (rgn == NULL) 

I 

sprintf (buf fer, "+ End %s (Empty) \n" , rgn_name) ; 

OutputDebugString (buf fer) ; 
return; 

) 

sprintf 
( 

buffer, 

°+ BBox:(%d, %d, %d, %d)\n", 
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rgn- >rr_BBox . X . Min , 
rgn- >rr_BBox . Y . Min , 

•rgn- >rr_BBox . X . Max, 
rgn - >r r_BBox . Y . Max 

); 

OutputDebugString (buffer) ; 

sprintf (buffer, "+ Nels: %d\n", rgn->rr_RgnDataSize) ; 

OutputDebugString (buff er) ; 

sprintf (buffer, "+ Data: ..."); 

OutputDebugString (buff er) ; 

for (index = 0; index < rgn->rr RgnDataSize; index++) 
{ 

if (rgn->rr RgnData (index] == R NEXT IS Y) 
{ " " " 

sprintf (buffer, "\n| Y:%3d--> \ rgn - >rr_RgnDa ta [++ index] ) ; 

line_len = strlen (buf f er) ; 

OutputDebugString (buffer) ; 

else if ( rgn- >rr_RgnData( index) == R_EOR) 

sprintf (buf fer, n \n+ End%s\n", rgn_name) ; 

OutputDebugString (buffer) ; 

•••• else 
{ 

sprintf (buf fer, "%3d, , rgn- >rr_RgnData [index] ) ; 
if (strlen (buffer) + line len > 80) 
{ 

OutputDebugString ("\n | «) ; 

line_len = strlen("\n| ") ; 

OutputDebugString (buf fer) ; 
line len += strlen(buf fer) ; 

) 



• ■ 
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) 
} 

tfdefine NUM_ ITERATIONS 200 
int 

R_test_new_region_arithmetic ( ) 

{ 



R_Reg ion 


rgnl ; 


R_Region 


rgn2 ; 


R_Region 


rgn3 ; 


R_Region 


rgn4 ; 


R_Reg ion 


rgn 5 ; 


R_Region 


rgn 6 ; 


IntXYMinMax 


rect ; 


int 


i; 


IntXY 


delta; 


char 


buf [256] ; 


unsigned long 


ticks_new; 


unsigned long 


ticks_old; 



#if 0 

/* 

* Union Test . 
*/ 

ticks_new = GetTickCount ( ) ; 
rect. X. Min = 50; 
rect. Y. Min = 50; 
rect. X.Max = 100; 
rect. Y.Max = 100; 

if ( !R_init_region_with_rect (trgnl, &rect) ) 

return FALSE; 
rect. X. Min = 70; 
rect. Y. Min = 70; 
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rect. X.Max = 120; 
rect. Y.Max = 120; 

if ( !R_init_region_with_rect (&rgn2, &rect) ) 

return FALSE; 
if ( !R_union_list_equals (&rgnl, &rgn2) ) 

return FALSE; 
delta. X = 5; 
delta . Y = 5; 

for (i = 0; i < NUM ITERATIONS; i++) 
{ 

R_translate_region (&rgn2, fcdelta) ; 
if ( !R_union_list_equals(&rgnl, &rgn2)) 
return FALSE; 

} 

ticks_new = GetTickCount ( ) - ticks_new; 

ticks_old = GetTickCount () ; 
rect.X.Min = St- 
reet. Y.Min = 50; 
rect. X.Max = 100; 
rect. Y.Max = 100; 

if ( !R_init_region_with_rect (&rgn3, &rect) ) 

return FALSE; 
rect.X.Min = 70; 
rect.Y.Min = 70; 
rect. X.Max = 120; 
rect. Y.Max = 120; 

if ( !R_init_region_with_rect (&rgn4 , &rect) ) 

return FALSE; 
if ( !R_union_equals (&rgn3, &rgn4) ) 

return FALSE; 
delta.X = 5; 
delta. Y = 5; 

for (i = 0; i < NUM_ITERATIONS; i++) 
{ 

R_translate_region(&rgn4, &delta) ; 
if ( !R_union_equalsUrgn3, &rgn4)) 
return FALSE; 

) 

ticks_old = GetTickCount ( ) - ticks_old; 

if (R_compare(&rgnl, &rgn3) ) 

sprintf(buf, "New & Old Region Implementations match. \n") ; 

else 

sprintf(buf, "New & Old Region Implementations DO NOT match. \n"); 
OutputDebugString (buf ) ; 

sprintf(buf, "Union Timings - New=%d vs 01d=%d\n", ticks_new, ticks_old) ; 
OutputDebugString (buf ) ; 

//R_output_region_as_debug_string ("New Region Description", &rgnl) ; 
//R_output_region_as_debug_string("01d Region Description", &rgn3) ; 

/* 

* Intersection Test. 
*/ 

R_empty_region ( &rgn2 ) ; 
R_empty_region(&rgn4) ; 
rect.X.Min = 70; 
rect.Y.Min = 70; 
rect. X.Max = 120; 
rect. Y.Max = 120; 

if ( !R_init_region_with_rect (&rgn2, &rect) ) 

return FALSE; 
delta.X a 5; 
delta. Y = 5; 

for (i . 0; i < NUM ITERATIONS; i++) 
{ 

if ( !R_intersection_list (&rgn5, &rgnl, &rgn2) ) 
return FALSE; 
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if ( !R_intersection(&rgn6, &rgn3, &rgn2) ) 

return FALSE; 
if < !R_compare (trgnS , &rgn6) ) 

{ 

sprintffbuf, "New & Old Region Implementations DO NOT match.\n n ); 
OutputDebugString (buf ) ; 

) 

R_empty_region (&rgn5 ) ; 
R_empty_region(&rgn6) ; 
R_translate_region (&rgn2, &delta) ; 

} 

ticks_new = GetTickCount { ) ; 
R_empty_region (&rgn2) ; 
rect.x.Min = 70; 
rect.Y.Min = 70; 
rect. X.Max = 120; 
rect. Y.Max = 120; 

if ( !R_init_region_with_rect (&rgn2, &rect) ) 

return FALSE; 
delta.X =5; 
delta. Y = 5; 

for (i = 0; i < NUM_ITERATIONS; i++) 
{ 

if ( !R_intersection_list (&rgn5, fcrgnl, &rgn2)) 

return FALSE; 
R_empty_region ( &rgn5 ) ; 
R_translate_region (&rgn2, &delta) ; 

} 

ticks_new = GetTickCount ( ) - ticks_new; 

ticks_old = GetTickCount () ; 
R_empty_ region ( &rgn2 ) ; 
rect.x.Min = 70; 
rect.Y.Min = 70; 
rect. X.Max = 120; 
rect. Y.Max = 120; 

if ( !R_init_region_with_rect (&rgn2 , trect) ) 

return FALSE ; 
delta.X = 5; 
delta.Y = 5; 

for (i = 0; i < NUM_ITE RAT IONS ; i++) 
{ 

if ( !R_intersection(&rgn6, &rgn3, &rgn2)) 

return FALSE; 
R_empty_region(&rgn6) ; 
Retranslate region (&rgn2 , fcdelta) ; 

) 

ticks_old a GetTickCount () - ticks_old; 

sprintf(buf, "Intersection Timings - New=%d vs 01d=%d\n", ticks_new, ticks_old) ; 
OutputDebugString (buf ) ; 

//R_output_region_as_debug_string ( "New Region Description", &rgnl) ; 
//R_output_region_as_debug_string ( "Old Region Description", &rgn3) ; 

R_empty_region(&rgnl) ; 
R_empty_region ( &rgn2 ) ; 
R_empty_region(&rgn3) ; 
R_empty_region (&rgn4 ) ; 
OutputDebugString ( "Done ! ! \n" ) ; 
tfendif 

return TRUE; 

) 
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The claims defining the invention are as follows: 

1. A method of creating an image, said image being formed by rendering at 
least a plurality of graphical objects to be composited according to a compositing 
expression, each said object having a predetermined outline, said method comprising the 

5 steps of: 

dividing a space in which said outlines are defined into a plurality of mutually 
exclusive regions wherein each of said regions is defined by a region outline substantially 
following at least one of said predetermined outlines or parts thereof; 

examining each said region to determine those said objects which contribute to 
10 said region; 

modifying said compositing expression on the basis of the contribution of each 
of said objects within said region to form an optimized compositing expression for each 
said region; and 

compositing said image using each of said optimized compositing expressions. 

15 

2. A method according to claim 1, further comprising the step of 
approximating each said predetermined outline on the outside and the inside to form an 
outline region. 

20 3. A method according to claims 2 , wherein each said outline region is 

approximated to a grid. 

4. A method according to claim 3, wherein said examining comprises 
determining whether or not an opacity of each said object within the corresponding region 

25 has non-zero opacity. 

5. A method according to claim 4, wherein said region outline is further 
defined by at least one attribute of at least one said object within the corresponding 
region. 

30 

6. A method according to claim 5, wherein said attribute is selected from 
the group consisting of colour, opacity and object outline. 



• • • • 

• • • • 
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7. A method according to any one of claims 1 to 6, wherein the compositing 
expression is a hierarchically structured representation of the image. 

8. A method according to any one of claims 1 to 7, wherein said image is at 
5 least in part a pixel-based image. 

9. A method according to any one of the preceding claims, wherein a flag is 
stored to indicate whether data of an object is opaque or ordinary. 

10 10. A method according to claim 9, wherein said compositing expression is 

optimized based on a value of said flag for contributing objects. 

11. A method according to any one of the preceding claims, wherein a 
wholly opaque object in said region acts to eliminate one or more objects within said . 

15 region from said compositing expressions. 

12. A method according to any one of the preceding claims, wherein a 
wholly transparent object in said region eliminates at least itself from said compositing 
expression. 

20 

13. A method according to any one of claims 1 to 12, wherein said modifying 
comprises modifying a manner in which said compositing expression is evaluated without 
modifying said hierarchically structured representation. 

25 14. A method of creating an image, said image being formed by rendering at 

least a plurality of graphical objects to be composited according to a compositing 
expression, each said object having a predetermined outline, said method comprising the 
steps of: 

dividing a space in which said outlines are defined into a plurality of mutually 
30 exclusive regions; 

examining each said region to determine those said objects which contribute to 
said region; 

modifying said compositing expression on the basis of the contribution of each 
of said objects within said region; and 
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compositing said image using said modified compositing expression. 

15. A method according to claim 14, wherein each of said regions is defined 
by a region outline substantially formed of at least one of said predetermined outlines or 
parts thereof 

16. A method according to claim 14, further comprising the step of 
approximating each said predetermined outline on the outside and the inside to form an 
outline region. 

17. A method according to claim 16, wherein each said outline region is 
approximated to a grid. 

18. A method according to any one of claims 14 to 17, wherein modifying 
said compositing expression forms an optimized compositing expression. 

19. A method according to any one of claims *14 to 18, wherein said 
examining comprises determining whether or not an opacity of each said object within the 
corresponding region has non-zero opacity. 

20. A method according to any one of claims 15 to 19, wherein said region 
outline is further defined by at least one attribute of at least one said object within, said 
corresponding region. 

21. A method according to claim 20, wherein said attribute is selected from 
the group consisting of colour, opacity and object outline. 

22. A method according to any one of claims 14 to 21, wherein the 
compositing expression is a hierarchical structure representation of the image. 

23. A method according to any one of claims 14 to 22, wherein said image is 
at least in part a pixel-based image. 



»••• 
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24. A method according to any one of claims 14 to 23, wherein a flag is 
stored to indicate whether data of an object is opaque or ordinary. 

25. A method according to claim 24, wherein said compositing expression is 
5 optimized based on a value of said flag for contributing objects. 

26. A method according to any one of claims 14 to 25, wherein a wholly 
opaque object in said region acts to eliminate one or more objects within said region from 
said compositing expression. 

10 

27. A method according to any one of claims 14 to 26, wherein a wholly 
transparent object eliminates at least itself from said compositing expression. 

28. A method according to any one of claims 14 to 27, wherein said 
15 modifying comprises modifying a manner in which said compositing expression is 

evaluated without modifying said hierarchical structure representation. 

29. A method of creating an image, said image comprising a plurality of 
graphical objects to be composited according to a compositing expression, said method 

20 comprising the steps of: 

dividing a space in which said graphical objects are defined into a plurality of 

regions; 

examining each said region to determine those said objects which contribute to 
said region; 

25 modifying said compositing expression on the basis of said examination; and 

compositing said image using said modified compositing expression. 

30. A method according to claim 29, wherein each said object has a 
predetermined outline. 

30 

31. A method according to claims 29 or 30, wherein said regions are 
mutually exclusive. 
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32. A method according to any one of claims 30 or 3 1, further comprising the 
step of approximating each said predetermined outline on the outside and the inside to 
form an outline region. 

5 33. A method according to claim 32, wherein each said outline region is 

approximated to a grid. 

34. A method according to any one of claims 29 to 33, wherein said 
compositing expression is modified on the basis of the contribution of each of said 

10 objects within each said region. 

35. A method according to any one of claims 29 to 34, wherein each of said 
regions is defined by a region outline substantially formed of at least one of said 
predetermined outlines or parts thereof. 

15 

36. A method according to any one of claims 29 to 35, wherein modifying 
said compositing expression forms an optimized compositing expression. 

37. A method according to any one of claims 29 to 36, wherein said 
20 examining comprises determining whether or not an opacity of each said object within the 

corresponding region has non-zero opacity. 

38. A method according to any one of claims 35 to 37, wherein said region 
outline is further defined by at least one attribute of at least one said object within the 

25 corresponding region. 

39. A method according to claim 38, wherein said attribute is selected from 
the group consisting of colour, opacity and object outline. 

30 40. A method according to any one of claims 29 to 39, wherein the 

compositing expression is a hierarchical structured representation of the image. 



41. A method according to any one of claims 29 to 40, wherein said image is 
at least in part a pixel-based image component. 



-122- 



42. A method according to any one of claims 29 to 41, wherein a flag is 
stored to indicate whether data of an object is opaque or ordinary. 

5 43. A method according to claim 42, wherein said compositing expression is 

optimized based on a value of said flag for contributing objects. 

44. A method according to any one of claims 29 to 43, wherein a wholly 
opaque object in said region acts to eliminate one or more objects within said region from 

10 said compositing expression. 

45. A method according to any one of claims 29 to 44, wherein a wholly 
transparent object in said region eliminates at least itself from compositing expression. 

15 46. A method according to any one of claims 29 to 45, wherein said 

modifying comprises modifying a manner in which said compositing expression is 
evaluated without modifying said hierarchical structured representation. 

47. An apparatus for creating an image, said image being formed by 
20 rendering at least a plurality of graphical objects to be composited according to a 
compositing expression, each said object having a predetermined outline, said apparatus 
comprising: 

dividing means for dividing a space in which said outlines are defined into a 
plurality of mutually exclusive regions wherein each of said regions is defined by a 
25 region outline substantially following at least one of said predetermined outlines or parts 
thereof; 

examining means for examining each said region to determine those said objects 
which contribute to said region; 

modifying means for modifying said compositing expression on the basis of the 
30 contribution of each of said objects within said region to form an optimized compositing 
expression for each said region; and 

compositing means for compositing said image using each of said optimized 
compositing expressions. 
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48. An apparatus according to claim 47, further comprising approximating 
means for approximating each said predetermined outline on the outside and the inside to 
form an outline region. 

5 49. An apparatus according to claims 48, wherein each said outline region is 

approximated to a grid. 

50. An apparatus according to claim 49, wherein said examining comprises 
determining whether or not an opacity of each said object within the corresponding region 

10 has non-zero opacity. 

51. An apparatus according to claim 50, wherein said region outline is further 
defined by at least one attribute of at least one said object within the corresponding 
region. 

15 

52. An apparatus according to claim 51, wherein said attribute is selected 
from the group consisting of colour, opacity and object outline. 

53. An apparatus according to any one of claims 47 to 52, wherein the 
20 compositing expression is a hierarchically structured representation of the image. 

54. An apparatus according to any one of claims 47 to 53, wherein said 
image is at least in part a pixel-based image. 

25 55. An apparatus according to any one of claims 47 to 54, wherein a flag is 

stored to indicate whether data of an object is opaque or ordinary. 

56. An apparatus according to claim 55, wherein said compositing expression 
is optimized based on a value of said flag for contributing objects. 



30 



57. An apparatus according to any one of claims 47 to 56, wherein a wholly 
opaque object in said region acts to eliminate one or more objects within said region from 
said compositing expressions. 
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58. An apparatus according to any one of claims 47 to 57, wherein a wholly 
transparent object in said region eliminates at least itself from said compositing 
expression. 

59. An apparatus according to any one of claims 47 to 58, wherein said 
modifying comprises modifying a manner in which said compositing expression is 
evaluated without modifying said hierarchically structured representation. 

60. An apparatus for creating an image, said image being formed by 
rendering at least a plurality of graphical objects to be composited according to a 
compositing expression, each said object having a predetermined outline, said apparatus 
comprising: 

dividing means for dividing a space in which said outlines are defined into a 
plurality of mutually exclusive regions; 

examining means for examining each said region to determine those said objects 
which contribute to said region; 

modifying means for modifying said compositing expression on the basis of the 
contribution of each of said objects within said region; and 

compositing means for compositing said image using said modified compositing 
expression. 

61. An apparatus according to claim 60, wherein each of said regions is 
defined by a region outline substantially formed of at least one of said predetermined 
outlines or parts thereof. 

62. An apparatus according to claim 60, further comprising approximating 
means for approximating each said predetermined outline on the outside and the inside to 
form an outline region. 

63. An apparatus according to claim 62, wherein each said outline region is 
approximated to a grid. 

64. An apparatus according to any one of claims 60 to 63, wherein modifying 
said compositing expression forms an optimized compositing expression. 
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65. An apparatus according to any one of claims 60 to 64, wherein said 
examining comprises determining whether or not an opacity of each said object within the 
corresponding region has non-zero opacity. 

5 

66. An apparatus according to any one of claims 61 to 65, wherein said 
region outline is further defined by at least one attribute of at least one said object within 
said corresponding region. 

10 67. An apparatus according to claim 66, wherein said attribute is selected 

from the group consisting of colour, opacity and object outline. 

68. An apparatus according to any one of claims 60 to 67, wherein the 
compositing expression is a hierarchical structure representation of the image. 

15 

69. An apparatus according to any one of claims 60 to 68, wherein said 
image is at least in part a pixel-based image. 

70. An apparatus according to any one of claims 60 to 69, wherein a flag is 
20 stored to indicate whether data of an object is opaque or ordinary. 

71 . An apparatus according to claim 70, wherein said compositing expression 
is optimized based on a value of said flag for contributing objects. 

25 72. An apparatus according to any one of claims 60 to 71, wherein a wholly 

opaque object in said region acts to eliminate one or more objects within said region from 
said compositing expression. 

73. An apparatus according to any one of claims 60 to 72, wherein a wholly 
30 transparent object eliminates at least itself from said compositing expression. 



74. An apparatus according to any one of claims 60 to 73, wherein said 
modifying comprises modifying a manner in which said compositing expression is 
evaluated without modifying said hierarchical structure representation. 
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75. An apparatus for creating an image, said image comprising a plurality of 
graphical objects to be composited according to a compositing expression, said apparatus 
comprising: 

dividing means for dividing a space in which said graphical objects are defined 
into a plurality of regions; 

examining means for examining each said region to determine those said objects 
which contribute to said region; 

modifying means for modifying said compositing expression on the basis of said 
examination; and 

compositing means for compositing said image using said modified compositing 
expression. 

76. An apparatus according to claim 75, wherein each said object has a 
predetermined outline. 

77. An apparatus according to claims 75 or 76, wherein said regions are 
mutually exclusive. 

78. An apparatus according to any one of claims 76 or 77, further comprising 
approximating means for approximating each said predetermined outline on the outside 
and the inside to form an outline region. 

79. An apparatus according to claim 78, wherein each said outline region is 
approximated to a grid. 

80. An apparatus according to any one of claims 75 to 79, wherein said 
compositing expression is modified on the basis of the contribution of each of said 
objects within each said region. 

81. An apparatus according to any one of claims 75 to 80, wherein each of 
said regions is defined by a region outline substantially formed of at least one of said 
predetermined outlines or parts thereof. 
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82. An apparatus according to any one of claims 75 to 81 , wherein modifying 
said compositing expression forms an optimized compositing expression. 

83. An apparatus according to any one of claims 75 to 82, wherein said 
examining comprises determining whether or not an opacity of each said object within the 
corresponding region has non-zero opacity. 

84. An apparatus according to any one of claims 81 to 83, wherein said 
region outline is further defined by at least one attribute of at least one said object within 
the corresponding region. 

85. An apparatus according to claim 84, wherein said attribute is selected 
from the group consisting of colour, opacity and object outline. 

86. An apparatus according to any one of claims 75 to 85, wherein the 
compositing expression is a hierarchical structured representation of the image. 

87. An apparatus according to any one of claims 75 to 86, wherein said 
image is at least in part a pixel-based image component. 

88. An apparatus according to any one of claims 75 to 87, wherein a flag is 
stored to indicate whether data of an object is opaque or ordinary. 

89. An apparatus according to claim 88, wherein said compositing expression 
is optimized based on a value of said flag for contributing objects. 

90. An apparatus according to any one of claims 75 to 81, wherein a wholly 
opaque object in said region acts to eliminate one or more objects within said region from 
said compositing expression. 

91. An apparatus according to any one of claims 75 to 90, wherein a wholly 
transparent object in said region eliminates at least itself from compositing expression. 
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92. An apparatus according to any one of claims 75 to 91, wherein said 
modifying comprises modifying a manner in which said compositing expression is 
evaluated without modifying said hierarchical structured representation. 

5 93. A method of creating a series of images, each member of said series being 

related to a preceding member, said images being formed by rendering a plurality of 
graphical objects to be composited according to a hierarchical structure representing a 
compositing expression, said hierarchical structure including a plurality of nodes each 
representing a component of at least one of said images, each of said objects having a 
10 predetermined outline, said method comprising the steps of: 

(a) for each said node: 

(i) dividing a component image space in which said outlines are 
defined into at least one mutually exclusive region, each said region being related to at 
least one graphical object; 
15 (ii) examining each said region to determine those objects that 

contribute to the region; 

(b) creating internodal dependency information identifying those said regions 
that will be affected by a change in any one of said regions; 

(c) rendering a first image of said series by compositing all regions 
20 substantially according to said hierarchical structure; 

(d) in response to at least one change to at least one of said nodes; 

(i) examining said internodal dependency information to identify 
those of said regions affected by said at least one change; 

(ii) for each node with affected regions, updating the corresponding 
25 identified regions and incorporating into said node those (any) new regions arising from 

the change and/or removing any of said regions that are no longer relevant; 

(iii) updating said internodal dependency information to reflect 
changes to said hierarchical structure; 

(iv) rendering a further image of said series by compositing (only) 
30 those regions affected by said at least one change; and 

(e) repeating step (d) for further changes to at least one of said nodes. 
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94. A method according to claim 93, further comprising the step of 
approximating each said predetermined outline on the outside and the inside to form an 
outline region. 

95. A method according to claim 94, wherein each said outline region is 
approximated to a grid. 

96. A method according to claim 93, wherein step (a)(ii) includes examining 
each said region to determine an opacity of each of said objects within said region. 

97. A method according to any one of claims 95 to 96, wherein said 
internodal dependency information is created for each of said regions. 

98. A method according to any one of claims 93, 96 or 97, wherein said 
internodal dependency information includes: 

a first internodal dependency list identifying those regions directly affected by a 
change to said one region; and 

a second internodal dependency list identifying those regions indirectly affected 
by a change in said one region. 

99. A method according to any one of claims 97 or 98, wherein directly 
affected regions are those regions having content modified as a consequence of change. 

100. A method according to any one of claims 97 to 99, wherein indirectly 
affected regions are those regions which may include modified region outlines and/or 
content generation as a result of change. 

101. A method according to any one of claims 95 to 100, wherein said region 
outline is further defined by at least one attribute of at least one said object within the 
corresponding region. 

102. A method according to claim 101, wherein said attribute is selected from 
the group consisting of colour, opacity and object outline. 
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103. A method according to any one of claims 93 to 102, wherein said 
updating include functions selected from the group consisting of deleting regions, altering 
the boundaries or regions. 

5 104. A method according to any one of claims 93 to 103, wherein at least one 

change includes changing the attributes of nodes in said hierarchical structure. 

105. A method according to any one of claims 93 to 104, wherein new regions' 
can be added to said hierarchical structure as a result of said at least one change to at least 

10 one of said nodes. 

106. A method according to any one of claims 93 to 105, wherein said image 
is at least in part a pixel-based image. 

15 107. A method according to any one of claims 93 to 106, wherein each of said 

mutually exclusive regions include a descriptor which represents an outline of said 
mutually exclusive region. 

108. A method according to any one of claims 93 to 107, wherein each of said 
20 regions includes a region descriptor which represents a union of all region descriptors of 

said node. 

109. A method according to any one of claims 93 to 108, wherein each of said 
regions is represented by a single proxy that provides for the reproduction of pixel data. 

25 

110. A method according to claim 109, wherein a flag is stored within each 
said proxy to indicate whether data in that region is opaque or ordinary. 

111. A method according to claim 110, wherein said compositing expression 
30 is optimized based on a value of said flag. 



112. A method according to any one of claims 93 to 111, wherein a wholly 
opaque object in said region acts to eliminate one or more objects within said region from 
said compositing expressions. 
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113. A method according to any one of claims 93 to 112, wherein a wholly 
transparent object in said region eliminates at least itself from said composition 
expression. 

5 

1 14. A method of creating a series of images, said images being formed by 
rendering a plurality of graphical objects to be composited according to a hierarchical 
structure, said hierarchical structure including a plurality of nodes each representing a 
component of at least one of said images, each of said objects having a predetermined 

10 outline, said method comprising the steps of: 

(a) for each said node: 

(iii) dividing a space in which said outlines are defined into at least 
one mutually exclusive region; 

(iv) examining each said region to determine those objects that 
15 contribute to the region; 

(b) creating internodal dependency information based on said examination; 

(c) rendering a first image of said series utilising said hierarchical structure; 
and then, in response to at least one change to at least one of said nodes; 

(d) examining said internodal dependency information; 

20 (i) for a node with affected regions, updating the corresponding 

regions; 

(ii) updating said internodal dependency information; 

(iii) rendering a further image of said series by compositing those 
regions affected by said at least one change; and 

25 (e) repeating step (d) for further changes to at least one of said nodes. 

115. A method according to claim 114, further comprising the step of 
approximating each said predetermined outline on the outside and the inside to form an 
outline region. 



30 



116. A method according to claim 115, wherein each said outline region is 
approximated to a grid. 
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1 17. A method according to claim 115, wherein each member of said series of 
images is related to a preceding member. 

118. A method according to any one of claims 116 or 1 17, wherein each said 
5 region is related to at least one graphical object. 

119. A method according to any one of claims 1 14 to 118, wherein rendering 
of said first image is executed by compositing all regions of said hierarchical structure. 

10 120. A method according to any one of claims 114 to 119, wherein said 

examining of said intemodal dependency information identifies those of said regions 
affected by said at least one change. 

121. A method according to any one of claims 114 to 120, wherein said 
15 updating of said intemodal dependency information reflects changes to said hierarchical 

structure. 

122. A method according to any one of claims 1 14 to 121, wherein step (a)(ii) 
includes examining each said region to determine an opacity of each of said objects 

20 within said region. 

123. A method according to any one of claims 114 to 122, wherein said 
intemodal dependency information is created for each of said regions. 

25 124. A method according to any one of claims 114 or 123, wherein said 

intemodal dependency information includes: 

a first intemodal dependency list identifying those regions directly affected by a 
change to said one region; and 

a second intemodal dependency list identifying those regions indirectly affected 
30 by a change in said one region. 



125. A method according to claim 123, wherein directly affected regions are 
those regions having content modified as a consequence of change. 
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126. A method according to any one of claims 123 to 125, wherein indirectly 
affected regions are those regions which may include modified region outlines and/or 
content generation as a result of change. 

5 127. A method according to any one of claims 1 14 to 126, wherein said region 

outline is further defined by at least one attribute of at least one said object within the 
corresponding region. 

128. A method according to claim 127, wherein said attribute is selected from 
10 the group consisting of colour, opacity and object outline. 

125. A method according to any one of claims 114 to 128, wherein said 
updating include functions selected from, the group consisting of deleting regions, altering 
the boundaries or regions. 

15 

130. A method according to any one of claims 1 1 4 to 128, wherein at least one 
change includes changing the attributes of nodes in said hierarchical structure. 

131. A method according to any one of claims 114 to 130, wherein new 
20 regions can be added to said hierarchical structure as a result of said at least one change to 

at least one of said nodes. 

132. A method according to any one of claims 1 14 to 131, wherein said image 
is at least in part a pixel-based image. 



25 



133. A method according to any one of claims 114 to 132, wherein each of 
said mutually exclusive regions include a descriptor which represents an outline of said 
mutually exclusive region. 



30 



134. A method according to any one claims 119 to 133, wherein each of said 
regions includes a region descriptor which represents a union of all region descriptors of 
said node. 
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135. A method according to any one claims 1 14 to 134, wherein each of said 
regions is represented by a single proxy that provides for the reproduction of pixel data. 
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136. A method according to claim 135, wherein a flag is stored within each 
5 said proxy to indicate whether data in that region is opaque or ordinary. 

137. A method according to claim 136, wherein said compositing expression 
is optimized based on a value of said flag. 

10 138. A method according to any one of claims 1 13 to 135, wherein a wholly 

opaque object in said region acts to eliminate one or more objects within said region from 
said compositing expressions. 

139. A method according to any one of claims 113 to 136, wherein a wholly 
transparent object in said region eliminates at least itself from said composition 

15 expression. 

140. A method of creating a series of images, said images being formed by 
rendering at least a plurality of graphical objects to be composited according to a 
hierarchical structure, said hierarchical structure including a plurality of nodes each 

20 representing a component of at least one of said images, said method comprising the steps 
of: 

(a) for each said node: 

(i) dividing a component image space in which said graphical objects 
are defined into at least one region; 

25 (ii) examining each said region; 

(b) creating internodal dependency information for each of said regions; 

(c) rendering a first image of said series utilising said hierarchical structure; 
and then, in response to at least one change to at least one of said nodes; 

(d) examining said internodal dependency information; 

30 (i) for a node with affected regions, updating the corresponding 

information; 

(ii) updating said internodal dependency record; 

(iii) rendering a further image of said series; and 

(e) repeating step (d) for further changes to at least one of said nodes. 
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141. A method according to claim 140, wherein each of said objects has a 
predetermined outline. 

5 142. A method according to claim 141, further comprising the step of 

approximating each said predetermined outline on the outside and the inside to form an 
outline region. 

143. A method according to claim 142, wherein each said outline region is 
10 approximated to a grid. 

144. A method according to any one of claims 140 to 143, wherein said 
regions are mutually exclusive. 

15 145. A method according to any one of claims 140 to 144, wherein said 

rendering a further image of said series is executed by compositing those regions affected 
by said at least one change. 

146. A method according to any one of claims 140 to 144, wherein each 
20 member of said series of images is related to a preceding member. <* 

147. A method according to any one of claims 140 to 146, wherein each said 
region is related to at least one graphical object. 

25 148. A method according to any one of claims 140 to 147, wherein rendering 

of said first image is executed by compositing all regions of said hierarchical structure. 

149. A method according to any one of claims 140 to 148, wherein said 
examining of said internodal dependency information identifies those of said regions 

30 affected by said at least one change. 

150. A method according to any one of claims 140 to 149, wherein said 
updating of said internodal dependency information reflects changes to said hierarchical 
structure. 
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151. A method according to any one of claims 140 to 150, wherein step (a)(ii) 
includes examining each said region to determine an opacity of each of said objects 
within said region. 

5 

152. A method according to any one of claims 140 to 151, wherein said 
intemodal dependency information is created for each of said regions. 

153. A method according to any one of claims 140 to 152, wherein said 
10 intemodal dependency information includes: 

a first intemodal dependency list identifying those regions directly affected by a 
change to said one region; and 

a second intemodal dependency list identifying those regions indirectly affected 
by a change in said one region. 

15 

154. A method according to any one of claims 152 to 153, wherein directly 
affected regions are those regions having content modified as a consequence of change. 

155. A method according to any one of claims 152, wherein indirectly affected 
20 regions are those regions which may include modified region outlines and/or content 

generation as a result of change. 

156. A method according to any one of claims 140 to 155, wherein said region 
outline is further defined by at least one attribute of at least one said object within the 

25 corresponding region. 

157. A method according to claim 156, wherein said attribute is selected from 
the group consisting of colour, opacity and object outline. 



30 



158. A method according to any one of claims 140 to 157, wherein said 
updating include functions selected from the group consisting of deleting regions, altering 
the boundaries or regions. 
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159. A method according to any one of claims 140 to 158, wherein at least one 
change includes changing the attributes of nodes in said hierarchical structure. 

160. A method according to any one of claims 140 to 159, wherein new 
regions can be added to said hierarchical structure as a result of said at least one change to 
at least one of said nodes. 

161. A method according to any one of claims 140 to 160, wherein said image 
is at least in part a pixel-based image. 

162. A method according to any one of claims 140 to 161, wherein each of 
said mutually exclusive regions include a descriptor which represents an outline of said 
mutually exclusive region. 



15 163. A method according to any one claims 140 to 161, wherein each of said 

regions includes a region descriptor which represents a union of all region descriptors of 
said node. 

164. A method according to any one claims 140 to 163, wherein each of said 
20 regions is represented by a single proxy that provides for the reproduction of pixel data. 

165. A method according to claim 164, wherein a flag is stored within each 
said proxy to indicate whether data in that region is opaque or ordinary. 

25 166. A method according to claim 165, wherein said compositing expression 

is optimized based on a value of said flag. 

167. A method according to any one of claims 140 to 166, wherein a wholly 
opaque object in said region acts to eliminate one or more objects within said region from 
30 said compositing expressions. 



168. A method according to any one of claims 140 to 167, wherein a wholly 
transparent object in said region eliminates at least itself from said composition 
expression. 
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169. An apparatus for creating a series of images, each member of said series 
being related to a preceding member, said images being formed by rendering a plurality 
of graphical objects to be composited according to a hierarchical structure representing a 
compositing expression, said hierarchical structure including a plurality of nodes each 
representing a component of at least of one of said images, each of said objects having a 
predetermined outline, said apparatus comprising: 

dividing means for dividing a component image space in which said outlines are 
defined , for each said node, into at least one mutually exclusive region, each said region 
being related to at least one graphical object ; 

first examining means for examining each said region, for each said node, to 
determine those objects that contribute to the region; 

creating means for creating an internodal dependency information identifying 
those said regions that will be affected by a change in any one of said regions; 

rendering means for rendering a first image of said series by compositing all 
regions substantially according to said hierarchical structure; 

second examining means for examining said internodal dependency information 
to identify those of said regions affected by at least one change to at least one of said 
nodes; 

first updating means for updating the corresponding identified regions for each 
node with affected regions and incorporating into said node those (any) new regions 
arising from the change; 

second updating means for updating said internodal dependency information to 
reflect changes to said hierarchical structure; and 

rendering means for rendering a further image of said series by compositing 
(only) those regions affected by said at least one change. 

170. An apparatus according to claim 169, further comprising an 
approximating means for approximating each said predetermined outline on the outside 
and the inside to form an outline region. 

171. An apparatus according to claim 170, wherein each said outline region is 
approximated to a grid. 
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172. An apparatus according to claim 169, wherein said first examining means 
examines each said region to determine an opacity of each of said objects within said 
region. 

5 173. An apparatus according to anyone of claims 169 to 172, wherein said 

intemodal dependency information is created for each of said regions. 

174. An apparatus according to any one of claims 169 or 173, wherein said 
internodal dependency information includes: 
10 a first internodal dependency list identifying those regions directly affected by a 

change to said one region; and 

a second internodal dependency list identifying those regions indirectly affected 
by a change in said one region. 

15 175. An apparatus according to claim 173, wherein directly affected regions 

are those regions having content modified as a consequence of change. 

176. An apparatus according to any one of claims 173, wherein indirectly 
affected regions are those regions which may include modified region outlines and/or 

20 content generation as a result of change. 

177. An apparatus according to any one of claims 169 to 172, wherein said 
region outline is further defined by at least one attribute of at least one said object within 
the corresponding region. 

25 

178. An apparatus according to claim 177, wherein said attribute is selected 
from the group consisting of colour, opacity and object outline. 

179. An apparatus according to any one of claims 167 to 178, wherein said 
30 updating the corresponding identified regions include functions selected from the group 

consisting of deleting regions and altering the boundaries of regions. 



180. An apparatus according to any one of claims 169 to 179, wherein at least 
one change includes changing the attributes of nodes in said hierarchical structure. 
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181. An apparatus according to any one of claims 169 to 180, wherein new 
regions can be added to said hierarchical structure as a result of said at least one change to 
at least one of said nodes. 

5 

182. An apparatus according to any one of claims 169 to 181, wherein said 
image is at least in part a pixel-based image. 

183. An apparatus according to any one of claims 169 to 182, wherein each of 
10 said mutually exclusive regions include a descriptor which represents an outline of said 

mutually exclusive region. 

184. An apparatus according to any one of claims 169 to 183, wherein each of 
said regions includes a region descriptor which represents a union of all region 

15 descriptors of said node. 

185. An apparatus according to any one of claims 169 to 184, wherein each of 
said regions is represented by a single proxy that provides for the reproduction of pixel 
data. 

20 

186. An apparatus according to claim 185, wherein a flag is stored within each 
said proxy to indicate whether data in that region is opaque or ordinary. 

187. An apparatus according to claim 186, wherein said compositing 
25 expression is optimized based on a value of said flag. 

188. An apparatus according to any one of claims 169 to 187, wherein a 
wholly opaque object in said region acts to eliminate one or more objects within said 
region from said compositing expressions. 



30 



189. An apparatus according to any one of claims 169 to 188, wherein a 
wholly transparent object in said region eliminates at least itself from said composition 
expression. 
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190. An apparatus for creating a series of images, said images being formed 
by rendering at least a plurality of graphical objects to be composited according to a 
hierarchical structure, said hierarchical structure including a plurality of nodes each 
representing a component of at least one of said images, each of said objects having a 
5 predetermined outline, said apparatus comprising: 

dividing means for dividing a space in which said outlines are defined, for each 
said node, into at least one mutually exclusive region; 

first examining means for examining each said region, for each said node, to 
determine those objects that contribute to the region; 
10 creating means for creating internodal dependency information based on said 

examination; 

rendering means for rendering a first image of said series utilising said 
hierarchical structure; and 

second examining means for examining said internodal dependency information 
15 in response to at least one change to at least one of said nodes and, for a node with 
affected regions, updating the corresponding regions, updating said internodal 
dependency information and, rendering a further image of said series by compositing 
those regions affected by said at least one change. 

20 191. An apparatus according to claim 190, further comprising an 

approximating means for approximating each said predetermined outline on the outside 
and the inside to form an outline region. 

192. An apparatus according to claim 191, wherein each said outline region is 
25 approximated to a grid. 

193. An apparatus according to claim 190, wherein each member of said series 
of images is related to a preceding member. 



30 



194. An apparatus according to any one of claims 192 or 193, wherein each 
said region is related to at least one graphical object. 
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195. An apparatus according to any one of claims 190 to 194, wherein 
rendering of said first image is executed by compositing all regions of said hierarchical 
structure. 



5 196. An apparatus according to any one of claims 190 to 195, wherein said 

examining of said internodal dependency information identifies those of said regions 
affected by said at least one change. 

197. An apparatus according to any one of claims 190 to 196, wherein said 
10 updating of said internodal dependency record reflects changes to said hierarchical 
structure. 



198. An apparatus according to any one of claims 190 to 197, wherein said 
first examining means examines each said region to determine an opacity of each of said 

15 objects within said region. 

199. An apparatus according to anyone of claims 190 to 198, wherein said 
internodal dependency information is created for each of said regions. 

20 200. An apparatus according to any one of claims 190 or 198, wherein said 

internodal dependency information includes: 

a first internodal dependency list identifying those regions directly affected by a 
change to said one region; and 

a second internodal dependency list identifying those regions indirectly affected 
25 by a change in said one region. 

201. An apparatus according to claim 200, wherein directly affected regions 
are those regions having content modified as a consequence of change. 
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202. An apparatus according to any one of claims 200, wherein indirectly 
affected regions are those regions which may include modified region outlines and/or 
content generation as a result of change. 
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203. An apparatus according to any one of claims 190 to 202, wherein said 
region outline is further defined by at least one attribute of at least one said object within 
the corresponding region. 

5 204. An apparatus according to claim 203, wherein said attribute is selected 

from the group consisting of colour, opacity and object outline. 

205. An apparatus according to any one of claims 190 to 204, wherein said 
updating include functions selected from the group consisting of deleting regions, altering 

10 the boundaries or regions. 

206. An apparatus according to any one of claims 190 to 205, wherein at least 
one change includes changing the attributes of nodes in said hierarchical structure. 

15 207. An apparatus according to any one of claims 190 to 205, wherein new 

regions can be added to said hierarchical structure as a result of said at least one change to 
at least one of said nodes. 

208. An apparatus according to any one of claims 190 to 207, wherein said 
20 image is at least in part a pixel-based image. 

209. An apparatus according to any one of claims 190 to 208, wherein each of 
said mutually exclusive regions include a descriptor which represents an outline of said 
mutually exclusive region. 



25 



210. An apparatus according to any one claims 190 to 209, wherein each of 
said regions includes a region descriptor which represents a union of all region 
descriptors of said node. 
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211. An apparatus according to any one claims 190 to 210, wherein each of 
said regions is represented by a single proxy that provides for the reproduction of pixel 
data. 
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212. An apparatus according to claim 211, wherein a flag is stored within each 
said proxy to indicate whether data in that region is opaque or ordinary. 

213. An apparatus according to claim 212, wherein said compositing 
expression is optimized based on a value of said flag. 

214. An apparatus according to any one of claims 190 to 212, wherein a 
wholly opaque object in said region acts to eliminate one or more objects within said 
region from said compositing expressions. 

215. An apparatus according to any one of claims 190 to 214, wherein a 
wholly transparent object in said region eliminates at least itself from said composition 
expression. 

216. An apparatus for creating a series of images, said images being formed 
by rendering at least a plurality of graphical objects to be composited according to a 
hierarchical structure, said hierarchical structure including a plurality of nodes each 
representing a component of at least one of said images, said apparatus comprising: 

dividing means for dividing a component image space, for each said node, in 
which said graphical objects are defined into at least one region; 
first examining means for examining each said region; 

creating means for creating internodal dependency information for each of said 

regions; 

rendering means for rendering a first image of said series utilising said 
hierarchical structure; 

second examining means for examining said internodal dependency information, 
in response to at least one change to at least one of said nodes; and 

first updating means for updating the corresponding regions for an affected node; 

second updating means for updating said internodal dependency information; 

and 

rendering means for rendering a further image of said series. 

217. An apparatus according to claim 216, wherein each of said objects has a 
predetermined outline. 
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218. An apparatus according to claim 217, further comprising approximating 
means for approximating each said predetermined outline on the outside and the inside to 
form an outline region. 

219. An apparatus according to claim 218, wherein each said outline region is 
approximated to a grid. 

220. An apparatus according to any one of claims 216 to 218, wherein said 
regions are mutually exclusive. 

221. An apparatus according to any one of claims 216 to 220, wherein said 
rendering a further image of said series is executed by compositing those regions affected 
by said at least one change. 

222. An apparatus according to any one of claims 216 to 220, wherein each 
member of said series of images is related to a preceding member. 

223. An apparatus according to any one of claims 216 to 222, wherein each 
said region is related to at least one graphical object. 

224. An apparatus according to any one of claims 216 to 223, wherein 
rendering of said first image is executed by compositing all regions of said hierarchical 
structure. 

225. An apparatus according to any one of claims 216 to 224, wherein said 
examining of said intemodal dependency record identifies those of said regions affected 
by said at least one change. 

226. Ah apparatus according to any one of claims 216 to 225, wherein said 
updating of said intemodal dependency record reflects changes to said hierarchical 
structure. 

227. An apparatus according to any one of claims 216 to 226, wherein said 
first examining means includes examining each said region to determine an opacity of 
each of said objects within said region. 
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228. An apparatus according to anyone of claims 216 to 227, wherein said 
internodal dependency information is created for each of said regions. 

5 229. An apparatus according to any one of claims 216 or 228, wherein said 

internodal dependency information includes: 

a first internodal dependency list identifying those regions directly affected by a 
change to said one region; and 

a second internodal dependency list identifying those regions indirectly affected 
10 by a change in said one region. 

230. An apparatus according to claim 229, wherein directly affected regions 
are those regions having content modified as a consequence of change. 

15 231. An apparatus according to any one of claims 229, wherein indirectly 

affected regions are those regions which may include modified region outlines and/or 
content generation as a result of change. 

232. An apparatus according to any one of claims 216 to 231, wherein said 
20 region outline is further defined by at least one attribute of at least one said object within 

the corresponding region. 

233. An apparatus according to claim 232, wherein said attribute is selected 
from the group consisting of colour, opacity and object outline. 



25 



234. An apparatus according to any one of claims 216 to 233, wherein said 
updating include functions selected from the group consisting of deleting regions, altering 
the boundaries or regions. 
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235. An apparatus according to any one of claims 216 to 234, wherein at least 
one change includes changing the attributes of nodes in said hierarchical structure. 
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236. An apparatus according to any one of claims 216 to 235, wherein new 
regions can be added to said hierarchical structure as a result of said at least one change to 
at least one of said nodes. 

5 237. An apparatus according to any one of claims 216 to 236, wherein said 

image is at least in part a pixel-based image. 

238. An apparatus according to any one of claims 216 to 237, wherein each of 
said mutually exclusive regions include a descriptor which represents an outline of said 

10 mutually exclusive region. 

239. An apparatus according to any one claims 216 to 238, wherein each of 
said regions includes a region descriptor which represents a union of all region 
descriptors of said node. 

15 

240. An apparatus according to any one claims 216 to 238, wherein each of 
said regions is represented by a single proxy that provides for the reproduction of pixel 
data. 

20 241. An apparatus according to claim 216 to 240, wherein a flag is stored 

within each said proxy to indicate whether data in that region is opaque or ordinary. 

242. An apparatus according to claim 241, wherein said compositing 
expression is optimized based on a value of said flag. 



25 



243. An apparatus according to any one of claims 216 to 242, wherein a 
wholly opaque object in said region acts to eliminate one or more objects within said 
region from said compositing expressions. 



30 



244. An apparatus according to any one of claims 216 to 243, wherein a 
wholly transparent object in said region eliminates at least itself from said composition 
expression. 
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245. A computer program product including a computer readable medium 
having a plurality of software modules for creating an image, said image being formed by 
rendering at least a plurality of graphical objects to be composited according to a 
compositing expression, each said object having a predetermined outline, said computer 

5 program product comprising: 

dividing module for dividing a space in which said outlines are defined into a 
plurality of mutually exclusive regions wherein each of said regions is defined by a 
region outline substantially following at least one of said predetermined outlines or parts 
thereof; 

10 examining module for examining each said region to determine those said 

objects which contribute to said region; 

modifying module for modifying said compositing expression on the basis of the 

contribution of each of said objects within said region to form an optimized compositing 

expression for each said region; and 
15 compositing module for compositing said image using each of said optimized 

compositing expressions, 

246. A computer program product including a computer readable medium 
having a plurality of software modules for creating an image, said image being formed by 

20 rendering at least a plurality of graphical objects to be composited according to a 
compositing expression, each said object having a predetermined outline, said computer 
program product comprising: 

dividing module for dividing a space in which said outlines are defined into a 
plurality of mutually exclusive regions; 
25 examining module for examining each said region to determine those said 

objects which contribute to said region; 

modifying module for modifying said compositing expression on the basis of the 
contribution of each of said objects within said region; and 

compositing module for compositing said image using said modified 
30 compositing expression. 



247. A computer program product including a computer readable medium 
having a plurality of software modules for creating an image, said image comprising a 
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plurality of graphical objects to be composited according to a compositing expression, 
said computer program product comprising: 

dividing module for dividing a space in which said graphical objects are defined 
into a plurality of regions; 
5 examining module for examining each said region to determine those said 

objects which contribute to said region; 

modifying module for modifying said compositing expression on the basis of 
said examination; and 

compositing module for compositing said image using said modified 
10 compositing expression. 

248. A computer program product including a computer readable medium 
having a plurality of software modules for creating a series of images, each member of 
said series being related to a preceding member, said images being formed by rendering a 
15 plurality of graphical objects to be composited according to a hierarchical structure 
representing a compositing expression, said hierarchical structure including a plurality of 
nodes each representing a component of at least one of said images, each of said objects 
having a predetermined outline, said computer program product comprising: 

dividing module for dividing a component image space in which said outlines 
20 are defined, for each said node, into at least one mutually exclusive region, each, said 
region being related to at least one graphical object ; 

first examining module for examining each said region, for each said node, to 
determine those objects that contribute to the region; 

creating module for creating an internodal dependency information identifying 
25 those said regions that will be affected by a change in any one of said regions; 

rendering module for rendering a first image of said series by compositing all 
regions of said hierarchical structure; 

second examining module for examining said internodal dependency information 
to identify those of said regions affected by at least one change to at least one of said 
30 nodes; 

first updating module for updating the corresponding identified regions for each 
node with affected regions and incorporating into said node those (any) new regions 
arising from the change; 
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second updating module for updating said internodal dependency information to 
reflect changes to said hierarchical structure; and 

rendering module for rendering a further image of said series by compositing 
(only) those regions affected by said at least one change. 

249. A computer program product including a computer readable medium 
having a plurality of software modules for creating a series of images, said images being 
formed by rendering a plurality of graphical objects to be composited according to a 
hierarchical structure, said hierarchical structure including a plurality of nodes each 
representing a component of at least one of said images, each of said objects having a 
predetermined outline, said computer program product comprising: 

dividing module for dividing a space in which said outlines are defined, for each 
said node, into at least one mutually exclusive region; 

first examining module for examining each said region, for each said node, to 
determine those objects that contribute to the region; 

creating module for creating an internodal dependency information based on said 
examination; 

rendering module for rendering a first image of said series utilising said 
hierarchical structure; and 

second examining module for examining said internodal dependency information 
in response to at least one change to at least one of said nodes and, for a node with 
affected regions, updating the corresponding regions, updating said internodal 
dependency information and, rendering a further image of said series by compositing 
those regions affected by said at least one change. 

250. A computer program product including a computer readable medium 
having a plurality of software modules for creating a series of images, said images being 
formed by rendering a plurality of graphical objects to be composited according to a 
hierarchical structure, said hierarchical structure including a plurality of nodes each 
representing a component of said image, said computer program product comprising: 

dividing module for dividing a component image space, for each said node, in 
which said graphical objects are defined into at least one region; 
first examining module for examining each said region; 
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creating module for creating internodal dependency information for each of said 

regions; 

rendering module for rendering a first image of said series utilising said 
hierarchical structure; 

second examining module for examining said internodal dependency 
information, in response to at least one change to at least one of said nodes; and 

first updating module for updating the corresponding regions for a node with 
affected regions; 

second updating module for updating said internodal dependency information; 

and 

rendering module for rendering a further image of said series. 

251. A method of processing image data for creating an image by rendering 
graphical objects to be composited according to a compositing expression, comprising the 
steps of: 

dividing a space in which said objects are defined into a plurality of regions in 
accordance with outlines of the objects; 

examining a part of the space by utilizing each said region; and 

modifying the compositing expression based on a result of said examining step. 

252. A method according to claim 251, wherein said examining k step 
comprises a step for determining the existence of each said objects. 

253. A method according to claim 252, wherein said examining step 
comprises a step for determining an opacity of each said objects. 

254. A method according to claim 251, wherein said examining step comprises a 
step for determining a change of the part between images of a plurality of images. 

DATED this Twentieth Day of August 1999 
Canon Kabushiki Kaisha 

Patent Attorneys for the Applicant 
SPRUSON & FERGUSON 
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